Fundamentals

Get Company Fundamental Data

Changed on

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

get/api/v3/companies/fundamentals

Request

  • Base URL
    https://app.daloopa.com
  • Auth
    HTTP basic

Query parameters

calendar_periodsstring[]

Optional list of calendar reporting periods to include. Mutually exclusive with fiscal_periods. When neither is provided, fundamentals for all periods are returned. 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_at__gtestring date-time

Minimum creation timestamp (ISO-8601, inclusive). Combine with created_at__lte to form a range.

created_at__ltestring date-time

Maximum creation timestamp (ISO-8601, inclusive). Combine with created_at__gte to form a range.

document_idinteger

Filter fundamentals to those from a specific document ID.

fiscal_periodsstring[]

Optional list of fiscal reporting periods to include. Mutually exclusive with calendar_periods. When neither is provided, fundamentals for all periods are returned. 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.

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_at__gtestring date-time

Minimum update timestamp (ISO-8601, inclusive). Combine with updated_at__lte to form a range.

updated_at__ltestring date-time

Maximum update timestamp (ISO-8601, inclusive). Combine with updated_at__gte to form a range.

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

Changes