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.

​
1. Get a company’s latest 10-K filing

Use the filings endpoint to pull the most recent annual report for Apple (CIK 320193): 
curl "https://api.ivory.finance/v1/filings/cik/320193?form_type=10-K&limit=1"
Response: 
[
  {
    "id": "0000320193-25-000008",
    "documentCategory": "annual-report",
    "title": "Apple Inc. — 10-K (2024-11-01)",
    "date": "2024-11-01",
    "fiscalYear": 2024,
    "fiscalPeriod": "annual",
    "companyId": "0000320193",
    "companyName": "Apple Inc.",
    "companyTickers": ["AAPL"],
    "originalFileUrl": "https://...",
    "markdownFileUrl": "https://..."
  }
]

​
2. Pull income statements

curl "https://api.ivory.finance/v1/financials/320193/income?period=FY&limit=4"

​
3. Search for companies

curl "https://api.ivory.finance/v1/companies/search?q=nvidia"

​
4. Get upcoming earnings

curl "https://api.ivory.finance/v1/earnings/upcoming?days=7"

​
5. Full-text search across disclosures

curl "https://api.ivory.finance/v1/search?q=artificial+intelligence+risk+factors&form_type=10-K&limit=10"

​
CIK vs Ticker

All company endpoints accept a CIK (Central Index Key). You can look up CIKs via the company search endpoint, or use the bulk facts endpoints which also accept tickers: 
# By ticker
curl "https://api.ivory.finance/v1/companies/facts/tickers?tickers=AAPL&tickers=MSFT"

# By CIK
curl "https://api.ivory.finance/v1/companies/facts/ciks?ciks=320193&ciks=789019"
CIKs are automatically zero-padded to 10 digits — 320193 and 0000320193 are equivalent.