Account

The key's owner and the key itself.

GET/api/v1/accountscope: api.<service>.read

Get the account and this key

Who 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.

Request

cURL

curl https://api.datafuel.ai/api/v1/account \
  --header 'Authorization: Bearer df_live_your_key_here'

Response

{
  "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"
  }
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

GET/api/v1/account/personal-datascope: api.<service>.manage

Export the account's personal data

Everything 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.

Request

cURL

curl https://api.datafuel.ai/api/v1/account/personal-data \
  --header 'Authorization: Bearer df_live_your_key_here'

Response

{}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}

{
  "error": "string",
  "message": "string",
  "meta": {}
}