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
- Sign up with your e-mail address or Google account.
- On Plan & billing, pick a plan and add a card. You're charged only if you keep the plan after the trial.
- On API keys, name the key after your app and select Create key.
- 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
- Browse the API reference for every endpoint, parameter and field.
- What can go wrong: errors and limits
- Ask in plain language instead: connect an AI assistant