---
title: "Get Taxonomy Fundamentals"
method: POST
path: "/api/v3/taxonomy/fundamentals"
tags: ["Taxonomy"]
---

# Get Taxonomy Fundamentals

`POST /api/v3/taxonomy/fundamentals`

## Request

- Base URL: `https://app.daloopa.com`
- URL: `https://app.daloopa.com/api/v3/taxonomy/fundamentals`
- Auth: HTTP basic

Return the paginated fundamentals of the series mapped to the given taxonomy metrics, for the given companies and periods. Rows have the same fields as the company fundamentals endpoint, plus `company_id`, `taxonomy_metric_id` and `taxonomy_metric_name`. Pass either `calendar_periods` or `fiscal_periods`; fiscal periods are converted to each company's calendar periods. Unknown company IDs, inactive metrics and periods without data are silently omitted.

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- TaxonomyFundamentalsQueryRequest: Reject requests that supply more than one of a configured field group. ``mutually_exclusive_fields`` lists the names that may not co-occur. "At most one" is always enforced. Set ``mutually_exclusive_required`` to True to also require at least one. Error messages are built from the field names. Checks run after delegating downstream, so list this mixin after any mixin that normalizes or folds the fields being checked (see ``LegacyFieldAliasMixin``).
  - `company_ids` integer[], required: List of company IDs (max 25)
  - `taxonomy_metric_ids` integer[], required: List of taxonomy metric IDs (max 25)
  - `fiscal_periods` string[]: List of fiscal periods (YYYYQQ, YYYYHH, or YYYYFY; max 10)
  - `calendar_periods` string[]: List of calendar periods (YYYYQQ, YYYYHH, or YYYYFY; max 10)

## Response `200`

- PaginatedTaxonomyFundamentalList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` TaxonomyFundamental[], required
    - `id` integer, required: Unique identifier for the fundamental datapoint
    - `label` string, required: Display label for the datapoint (e.g., revenue, ebitda)
    - `category` string, required: Category grouping for the datapoint (income, balance sheet, cash flow, etc.)
    - `restated` boolean, required: Indicates whether the value has been restated
    - `document_type` string, required: Type of the source document (e.g., 10-K, 10-Q, EX-99.1, EX-99.2)
    - `filing_type` string, required: Filing type the datapoint originates from (e.g., 10-K, 10-Q)
    - `series_id` integer, required: Identifier of the series associated with this datapoint
    - `title` string, required: Full title of the series as presented in the model
    - `value_raw` number, double, required: Original reported numeric value before normalization
    - `value_normalized` number, double, required: Value normalized to the system's standard unit/scale
    - `unit` string, required: Unit of measure for the value (e.g., USD)
    - `original_unit` string, nullable, required: The unit the value was originally reported in, before any conversion
    - `conversion_factor` string, required: Multiplier applied to convert value_normalized from original_unit to unit. Equals '1' when no conversion was applied.
    - `calendar_period` string, required: Calendar period for the datapoint (YYYYQQ/HH/FY format)
    - `fiscal_period` string, required: Fiscal period for the datapoint (YYYYQQ/HH/FY format)
    - `span` string, required: Time span covered by the datapoint (e.g., Q1, FY, trailing 12 months)
    - `fiscal_date` string, date, required: Fiscal period end date associated with the datapoint
    - `document_id` integer, required: Identifier of the source document for this datapoint
    - `filing_date` string, date, required: Date when the underlying filing was made public
    - `document_released_at` string, date-time, required: Timestamp when the source document was released
    - `created_at` string, date-time, required: Timestamp when the datapoint was first created
    - `updated_at` string, date-time, required: Timestamp when the datapoint was last updated
    - `derived_components` FundamentalDerivedComponents
      - `formula` string, required
      - `components` FundamentalDerivedComponent[], required
        - `component` string, required
        - `fundamental_id` integer, required
        - `value` number, double, required
    - `company_id` integer, required
    - `taxonomy_metric_id` integer, required
    - `taxonomy_metric_name` string, required

## Other responses

- `400`
- `401`
- `403`
- `429`

## Changes

- **2026-11-03** `90ca7c9d6f4e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/daloopa/apis/daloopa-api/changes/api/v3/taxonomy/fundamentals/post.md)

---

[API](https://skmtc.dev/daloopa/apis/daloopa-api.md) - [All operations](https://skmtc.dev/daloopa/apis/daloopa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/daloopa/apis/daloopa-api/revisions/90ca7c9d6f4e?raw)