Skip to main content
GET
/
v1
/
filings
/
company
/
{company_id}
Get filings by company
curl --request GET \
  --url https://api.ivory.finance/v1/filings/company/{company_id} \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "<string>",
    "title": "<string>",
    "companyId": "<string>",
    "documentCategory": "<string>",
    "description": "<string>",
    "date": "2023-12-25",
    "fiscalQuarter": 123,
    "fiscalYear": 123,
    "fiscalPeriod": "<string>",
    "companyName": "<string>",
    "companyTickers": [],
    "metadata": {},
    "language": "en",
    "originalFileUrl": "<string>",
    "markdownFileUrl": "<string>"
  }
]

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.

​
Company ID formats

The company_id path parameter accepts any of the following formats:
FormatExampleDescription
TICKER:EXCHANGEAAPL:NASDAQ, SHEL:LON, BAC:NYSETicker and exchange name (case-insensitive). Best for active listed companies.
CC:external_idGB:00445790, US:00012345672-letter country code + external identifier (CRN, CIK, ISIN, etc.).
UUID3f2a1b4c-...Internal UUID — stable across renames, delistings, and jurisdiction changes.
Bare CIK0001318605US companies only. Zero-padded or plain numeric.
Bare external ID00445790Best-effort match across all jurisdictions. May be ambiguous.
Note on delisted companies: tickers are recycled over time. For historical or delisted companies use CC:external_id or UUID to guarantee the correct entity.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
company_id
string
required

Query Parameters

​
form_type
string | null

Filter by SEC form type (case-insensitive). Any form type present in the database is accepted, e.g. 10-K, 10-Q, 8-K, 6-K, 20-F, S-1, DEF 14A, SC 13G, 4, 13F-HR, and 250+ others.

​
limit
integer
default:50
Required range: 1 <= x <= 500
​
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

​
id
string
required
​
title
string
required
​
companyId
string
required
​
documentCategory
string | null
​
description
string | null
​
date
string<date> | null
​
fiscalQuarter
integer | null
​
fiscalYear
integer | null
​
fiscalPeriod
string | null
​
companyName
string | null
​
companyTickers
string[]
​
metadata
Metadata · object
​
language
string
default:en
​
originalFileUrl
string | null
​
markdownFileUrl
string | null