Orders
Orders across every service.
/api/v1/orders List orders
GET /api/v1/ordersOrders placed through the API or the dashboard, newest first, for the services this key may read. A summary: payment and paid_at are on GET /api/v1/orders/{id}.
Requires the read level on at least one service.
limitinteger50.offsetinteger0.servicestringstatusstringcurl https://api.datafuel.ai/api/v1/orders \ --header 'Authorization: Bearer df_live_your_key_here'
OK.
{ "results": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "pending", "service": "string", "product": "string", "action": "new", "total": 0, "currency": "usd", "plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "action_url": "https://example.com", "error": { "code": "insufficient_balance", "message": "string" }, "created_at": "2026-01-01T00:00:00Z" } ], "count": 0, "limit": 0, "offset": 0 }
The request is malformed: message maps each invalid field to its problem, or is a sentence when the body cannot be read at all.
{ "error": "string", "message": "string", "meta": {} }
The API key is missing, invalid, expired or revoked.
{ "error": "string", "message": "string", "meta": {} }
The key lacks the scope named in meta.required (or the level in meta.required_level), is used from an IP it does not allow, or the account is suspended.
{ "error": "string", "message": "string", "meta": {} }
Too many requests for this key; retry after the Retry-After seconds.
{ "error": "string", "message": "string", "meta": {} }
Something failed on our side and was logged; read the resource again before retrying a change.
{ "error": "string", "message": "string", "meta": {} }
/api/v1/orders/{order} Get an order
GET /api/v1/orders/{order}Poll this after a 202 until the status is completed, delivery_failed, failed, expired or refunded, and stop after a few minutes: a delivery normally takes seconds. plan_id is the delivered plan's id, usable with that service's /plans/{plan}.
Requires the read level on at least one service.
order REQUIREDstringcurl https://api.datafuel.ai/api/v1/orders/{order} \ --header 'Authorization: Bearer df_live_your_key_here'
OK.
{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "pending", "service": "string", "product": "string", "action": "new", "total": 0, "currency": "usd", "payment": { "method": "balance", "card_id": "string" }, "plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "action_url": "https://example.com", "error": { "code": "insufficient_balance", "message": "string" }, "replayed": false, "created_at": "2026-01-01T00:00:00Z", "paid_at": "2026-01-01T00:00:00Z" }
The API key is missing, invalid, expired or revoked.
{ "error": "string", "message": "string", "meta": {} }
The key lacks the scope named in meta.required (or the level in meta.required_level), is used from an IP it does not allow, or the account is suspended.
{ "error": "string", "message": "string", "meta": {} }
No such resource, or it does not belong to the key's owner.
{ "error": "string", "message": "string", "meta": {} }
Too many requests for this key; retry after the Retry-After seconds.
{ "error": "string", "message": "string", "meta": {} }
Something failed on our side and was logged; read the resource again before retrying a change.
{ "error": "string", "message": "string", "meta": {} }