Account
The key's owner and the key itself.
/api/v1/account Get the account and this key
GET /api/v1/accountWho the key belongs to and what it may do: its permissions, services, limits and this month's spending. A cheap way to check a key works.
Requires the read level on at least one service.
curl https://api.datafuel.ai/api/v1/account \ --header 'Authorization: Bearer df_live_your_key_here'
OK.
{ "user_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "email": "you@example.com", "key": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "string", "prefix": "lc_live_7Qm2Xa9k…", "permissions": [ "string" ], "services": [ "string" ], "allowed_ips": [ "string" ], "monthly_limit": 0, "spent_this_month": 0, "expires_at": "2026-01-01T00:00:00Z", "last_used_at": "2026-01-01T00:00:00Z", "created_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": {} }
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/account/personal-data Export the account's personal data
GET /api/v1/account/personal-dataEverything held about the account, for a data access request: the profile and sign-in methods, orders, plans at every service, the wallet with payments, invoices and billing details, notifications and saved preferences. Secrets such as proxy passwords are left out.
Requires the manage level on at least one service.
curl https://api.datafuel.ai/api/v1/account/personal-data \ --header 'Authorization: Bearer df_live_your_key_here'
OK.
{}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": {} }