Skip to content

Make your first request

Create an API key, then look up a company and its earnings. New accounts can start a free trial on their chosen plan.

Create an API key

  1. Sign up with your e-mail address or Google account.
  2. On Plan & billing, pick a plan and add a card. You're charged only if you keep the plan after the trial.
  3. On API keys, name the key after your app and select Create key.
  4. Copy the key. It starts with fdb_ and is shown once, so store it in your app's secrets.

Look up a company

Send the key in the Authorization header:

curl "https://financialdb.ai/api/v1/profile?q=AAPL:US" \
  -H "Authorization: Bearer $FDB_API_KEY"

You get the company's name, description, sector, size, addresses and main listing. If the identifier matches nothing or several companies, you get a 404 that says what to try instead.

Get its earnings

curl "https://financialdb.ai/api/v1/earnings?q=AAPL:US&period=quarterly&limit=4" \
  -H "Authorization: Bearer $FDB_API_KEY"

Each row is one period, newest first. To page back, send next_offset from the response as offset. If the company doesn't report the period you asked for, available_periods says which it does.

Next steps

Esc

Documentation

Make your first request API keys and authentication Errors and limits Connect an AI assistant (MCP) Usage and billing Contact support Get company profile Get securities and listings Get reported earnings Get financial statements Get historical financial metrics Get financial segments Get historical shares outstanding Get fund holdings Find funds holding a security Screen companies Get screener filters
↑↓ to move to open