Ctrl+K

Get billing task by ID

get/api/v2/admin/billing/tasks/{taskId}

Returns a billing task associated with the public ID.

Path Parameters

  • taskIdstringRequired
    The public ID of the billing task
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$

200 Response

task object
id string required
Public ID of the billing task
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
state string required
Current state of the task object
Allowed values: pending started finished failed
updatedAt string <date-time>required
Date of most recent update to this task
pricingPlanId string
Optional pricing plan to use for all reports generated by this task
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
meta object required
An object containing metadata about this task
sendEmail boolean
Set to true if email notifications will be sent once this task is complete
newPlans boolean
Set to true if the billing worker should only bill enterprises with new pricing plans. Set to false if we should only bill enterprises with old pricing plans.
errors array[object] required
A list of billing errors, per enterprise to be billed, that were caught asynchronously during bill calculation
notes array[string]
List of notes that will be attached to each report linked to this billing task

400 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code