Billionaire data API documentation

The BillionaireList API gives you the same data as the site in a form your systems can use: the ranking with filters, full profiles, net worth history and daily changes. Every net worth figure comes with its date and its source, as separate fields.

The API is included in the Data and Enterprise plans. For an overview of what the API is for, code samples and how it compares with scraping public rankings, see the billionaires API page.

Plans and quotas

Quotas count requests made in your billing period and reset when a new period starts. When you exceed the quota, the API answers with status 429 until the next period or until you move to a higher plan. Your current usage is shown in your account next to your keys.

Authentication

Create a key in your account under API. Send it with every request in the Authorization header.

Authorization: Bearer <key>

Keys are shown once when created and stored only as hashes. You can revoke a key at any time, and it stops working immediately.

Base URL

https://billionairelist.com/api/v1

All responses are JSON in UTF-8. Amounts are whole US dollars. Dates use the format YYYY-MM-DD.

Endpoints

List billionaires

GET /billionaires

Returns the current ranking. Optional parameters:

Example request:

curl -H "Authorization: Bearer <key>" \
  "https://billionairelist.com/api/v1/billionaires?country=united-states&industry=technology&min=10&per_page=2"

Example response (illustrative values):

{
  "data": [
    {
      "rank": 1,
      "slug": "example-person",
      "name": "Example Person",
      "net_worth_usd": 12345000000,
      "as_of": "2026-01-15",
      "source": {
        "publisher": "Example Publisher",
        "url": "https://example.com/source"
      },
      "country": "US",
      "industry": "technology",
      "self_made": true,
      "age": 50,
      "change_usd": 100000000,
      "change_pct": 0.82
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 2,
    "total": 1,
    "updated": "2026-01-16"
  }
}

Get one billionaire

GET /billionaires/{slug}

Returns the full profile: identity facts, latest estimate with date and source, companies and roles, key events and the list of sources.

Example response (illustrative values):

{
  "data": {
    "rank": 1,
    "slug": "example-person",
    "name": "Example Person",
    "net_worth_usd": 12345000000,
    "as_of": "2026-01-15",
    "source": {
      "publisher": "Example Publisher",
      "url": "https://example.com/source"
    },
    "country": "US",
    "industry": "technology",
    "self_made": true,
    "age": 50,
    "change_usd": 100000000,
    "change_pct": 0.82,
    "companies": [
      { "name": "Example Company", "role": "founder" }
    ],
    "sources": [
      {
        "publisher": "Example Publisher",
        "url": "https://example.com/source",
        "date": "2026-01-15"
      }
    ]
  }
}

Get net worth history

GET /billionaires/{slug}/history

Returns every stored estimate for one person, oldest first, each with its date and source.

Example response (illustrative values):

{
  "data": [
    {
      "as_of": "2025-06-30",
      "net_worth_usd": 11000000000,
      "source": { "publisher": "Example Publisher", "url": "https://example.com/a" }
    },
    {
      "as_of": "2026-01-15",
      "net_worth_usd": 12345000000,
      "source": { "publisher": "Example Publisher", "url": "https://example.com/b" }
    }
  ]
}

Get latest changes

GET /changes

Returns people whose estimate changed, with the previous and latest figures and both dates. Use since=YYYY-MM-DD to return only changes recorded on or after that date.

Example response (illustrative values):

{
  "data": [
    {
      "slug": "example-person",
      "name": "Example Person",
      "net_worth_usd": 12345000000,
      "as_of": "2026-01-15",
      "previous_usd": 12245000000,
      "previous_as_of": "2026-01-14",
      "change_usd": 100000000,
      "change_pct": 0.82,
      "source": { "publisher": "Example Publisher", "url": "https://example.com/source" }
    }
  ]
}

Webhooks

On Data and Enterprise you can register a webhook URL in your account. After the daily ranking rebuild we send one POST request with the day's changes in the same shape as the /changes response. Each delivery is signed with a secret shown in your account, so you can verify it came from us. Failed deliveries are retried.

Errors

Error responses include a short message field explaining the problem.

Licence

Data from the API may be used in your internal work and, on Data and Enterprise, in internal and client reports. Reselling or redistributing the dataset itself is not permitted. Cite the source link of a figure when you publish it. The terms of service set out the licence in full.