Get task status and results
Get Task Status and Results
Check task status and read results after completion.
GET
Get task status and results
Get Task Status and Results
Query a task bytask_id. When the task status is succeeded, the response automatically includes the first page of normalized results. Use cursor and limit on the same endpoint to read additional result pages.
Endpoint
next_cursor returned under results to read the next page:
Response
Response Fields
| Field | Type | Description |
|---|---|---|
task_id | string | Task identifier |
status | string | queued, running, succeeded, or failed |
result_count | integer | Number of collected records |
error_message | string | Failure reason when status is failed |
credits_amount | number | Credits charged for the task |
created_time | string | Task creation time |
finished_time | string | Task completion time |
results | object | Present only when status is succeeded; contains paginated normalized records |
Pagination
| Query | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Number of records to return, max 500 |
cursor | string | null | Cursor from the previous results.next_cursor. Omit it for the first page. |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Task ID returned by the submit endpoint
Example:
"A1B2C3D4E5F6G7H8"
Query Parameters
Cursor returned by the previous data.results.next_cursor. Omit for the first page.
Maximum number of result records to return.
Required range:
1 <= x <= 500
