API ReferenceTasks
List your tasks
Lists the tasks created by the calling API key, newest first. Supports an optional status filter and limit/offset pagination. Payloads are returned as last stored; unlike GET /tasks/{task_id}, this endpoint does not re-check payload freshness, so always fetch a single task before submitting its payload.
Authorization
ApiKeyAuth AuthorizationBearer <token>
An API key for task submission and polling, sent as Authorization: Bearer gk_....
In: header
Query Parameters
status?string
Return only tasks in this lifecycle state.
Value in
- "queued"
- "processing"
- "ready"
- "failed"
- "expired"
limit?integer
Maximum number of tasks to return. Defaults to 50 and is clamped to the range 1 to 200.
Format
int64Range
1 <= value <= 200Default
50offset?integer
Number of tasks to skip, for pagination. Negative values are treated as 0.
Format
int64Range
0 <= valueDefault
0Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tasks"[ { "task_id": "9b2f7d41-6c3a-4e58-9d0b-1a4f8e2c7b33", "status": "queued", "created_at": 1753180845, "updated_at": 1753180845, "error": null, "payload": null }, { "task_id": "3f8c1e02-9a4b-4c7d-8e1f-2b6a5c9d0e11", "status": "ready", "created_at": 1753180800, "updated_at": 1753180812, "error": null, "payload": { "to": "0x0000000000000000000000000000000000000001", "data": "0x93de4531000000000000000000000000000000000000000000000000000000000000002a", "value": "0x0", "chain_id": 11155111, "estimated_gas": 234000, "valid_until_block": 22345678 } }]{ "error": { "code": "INVALID_REQUEST", "message": "Failed to deserialize query string" }}{ "error": { "code": "UNAUTHORIZED", "message": "Unauthorized" }}{ "error": { "code": "INTERNAL", "message": "Internal error: task queue unavailable" }}{ "error": { "code": "NOT_CONFIGURED", "message": "Persistence is not configured" }}