Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Your API Key

All API endpoints require an API key. Get a free key instantly — no credit card required.

Get Free API Key

Register in seconds and receive your key immediately.

​
Using Your Key

Pass the key as a header with every request: 
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.ivory.finance/v1/companies/search?q=apple"
You can also pass it as a query parameter: 
curl "https://api.ivory.finance/v1/filings/recent?api_key=YOUR_API_KEY"

​
Plans

PlanReq / minReq / dayHistorical data
Free51,0002 years
GrowthUnlimitedUnlimited10 years
ProUnlimitedUnlimited30 years
EnterpriseUnlimitedUnlimitedUnlimited
To upgrade your plan, email hello@ivory.finance.

​
Error Codes

All errors return a standard JSON body: 
{
  "detail": "Invalid API key"
}
StatusMeaning
401Missing or invalid API key
429Rate limit exceeded — upgrade your plan
400Bad request — invalid parameters
404Resource not found
422Validation error — check parameter types
503Service temporarily unavailable