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–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": "736fde4d-9029-4915-8189-01353d6982cb", "status": "queued", "created_at": 0, "updated_at": 0, "error": "string", "payload": { "to": "0x0000000000000000000000000000000000000001", "data": "0x93de4531", "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" }}