Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-244065126.5 KB
Fundamentals

Get Company Fundamental Data

Retrieve paginated fundamental financial data for a specific company and time periods.

get/api/v2/companies/fundamentals

Query parameters

calendar_periodsstring[]

List of calendar reporting periods to include. Mutually exclusive with fiscal_periods and periods. Accepted formats: YYYYQ[1-4] (quarters), YYYYH[1-2] (half-years), or YYYYFY (fiscal year). Example: ?calendar_periods=2023Q4&calendar_periods=2024Q1.

company_idinteger required

The unique identifier of the company.

created_atstring date-time

Minimum creation timestamp (ISO-8601). Used together with updated_at to form an inclusive range; created_at must be ≤ updated_at.

document_idinteger

Filter fundamentals to those from a specific document ID.

fiscal_periodsstring[]

List of fiscal reporting periods to include. Mutually exclusive with calendar_periods and periods. Accepted formats: YYYYQ[1-4] (quarters), YYYYH[1-2] (half-years), or YYYYFY (fiscal year). Example: ?fiscal_periods=2023Q4&fiscal_periods=2024Q1.

include_derivedboolean

Whether to include derived fundamentals. true = include derived fundamentals, false = exclude derived fundamentals, omit for default behavior (excludes derived).

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return results.

periodsstring[]

Deprecated: use calendar_periods. List of calendar reporting periods to include. Accepted formats: YYYYQ[1-4] (quarters), YYYYH[1-2] (half-years), or YYYYFY (fiscal year). Example: ?periods=2023Q4&periods=2024Q1.

restatedboolean

Filter by restatement status. true = only restated values, false = only original values, omit to include both.

sectionsstring[]

Optional list of financial statement sections to filter by. Narrows the response to fundamentals whose finantial section matches one of the provided values.

series_idsinteger[]

Optional list of series IDs to filter by. Example: ?series_ids=101&series_ids=205.

unit'actual' | 'billion' | 'million' | 'thousand' | 'trillion'

Optional target unit to convert values to. When omitted, values are returned as-reported. Values reported in a currency (e.g. dollars) or as a percentage are not convertible and are returned unchanged.

updated_atstring date-time

Maximum update timestamp (ISO-8601). Used together with created_at to form an inclusive range; created_at must be ≤ updated_at.

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"
}