v1

latestOpenAPI 3.0.3Proprietary2026-07-244065126.5 KB
Documents

Company Document Lookup

Retrieve paginated list of documents for a specific company, optionally filtered by quarter and filing type. Use calendar_quarters or fiscal_quarters (repeatable, mutually exclusive) to filter on one or more quarters; fiscal_quarters are translated to the company's calendar quarters before filtering. The legacy period and periods parameters are deprecated and fold into calendar_quarters. Each document in the response carries both calendar_quarter and fiscal_quarter. Results are ordered by filing date descending.

get/api/v2/documents

Query parameters

calendar_quartersstring[]

One or more calendar quarters in YYYYQ# format. Repeat the parameter to filter on several at once (e.g., ?calendar_quarters=2024Q1&calendar_quarters=2024Q2). Mutually exclusive with fiscal_quarters.

company_idinteger required

The unique identifier of the company.

filing_type'10-K' | '10-Q' | '8-K' | 'News Article' | 'Other' | 'Transcript'

Type of filing to filter by.

fiscal_quartersstring[]

One or more fiscal quarters in YYYYQ# format. Translated to the company's calendar quarters before filtering. Mutually exclusive with calendar_quarters.

has_fundamentalsboolean

When true, restrict the result set to documents that have at least one related Fundamentals row. When omitted or false, behavior is unchanged.

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return results.

periodstring

Deprecated: use calendar_quarters. Single calendar quarter in YYYYQ# format (e.g., '2023Q1', '2024Q4').

periodsstring[]

Deprecated: use calendar_quarters. One or more calendar quarters in YYYYQ# format. Repeat the parameter to filter on several at once (e.g., ?periods=2024Q1&periods=2024Q2).

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}