Skip to main content
GET
List Tasks
Returns the tasks created with your API key, newest first, each in the same shape as Get Task Status (including result once finished). Use it to follow a whole batch with one request instead of polling each task. Task reads have their own rate limit of 600 requests per minute per key, separate from the 100 per minute shared by every other endpoint.

Endpoint

Query Parameters

string
Only tasks of this type, e.g. contacts_extraction. See the type values on Get Task Status.
string
Only tasks in this state: queued, processing, finished, failed, or canceled.
integer
default:"100"
How many tasks to return, 1 to 1,000.
integer
default:"0"
How many tasks to skip, for paging through older ones.

Response

An array of task objects, newest first. See Get Task Status for the fields.

Example

cURL

Error Responses

Missing or invalid API key.
Unknown task_type or state, or limit outside 1 to 1,000.