Retrieve Company Financials - FinancialReports

Experimental endpoint — the response schema may change without an API version bump.

Returns standardized financial KPIs for a company as a structured document: a company envelope containing periods, each holding its Income Statement, Balance Sheet and Cash Flow statements, each holding line_items.

When several filings report the same period, the candidates are ranked and one statement is selected. A filing the company reports its own financials in beats one it does not, such as an employee benefit plan's Form 11-K or a filing notice. A statement in the currency the company reports in beats an off-currency one, which is usually a subsidiary's filing that resolved to the parent. A complete statement beats a fragment, such as the single restated line in an amendment. Only then does the most recently published filing win. A selected statement denominated in a currency other than the company's carries currency_mismatch: true.

Every contributing filing is listed in the statement's sources array. source_filing and sources are returned only for accounts with source unmasking enabled (sources_masked reports which applies). Use as_of=YYYY-MM-DD for a point-in-time view.

Use the depth and parent_code fields on each line item to render the Capital IQ-style statement hierarchy.

Access Level Required: Requires Financial KPIs (Level 3).

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Structured company financials document.

Bodyapplication/json

Example

{
    "company_id": 100,
    "currency": {
        "code": "EUR",
        "name": "Euro",
        "symbol": "€"
    },
    "sources_masked": false,
    "filters": {
        "statement_type": null,
        "fiscal_year": null,
        "fiscal_year_from": null,
        "fiscal_year_to": null,
        "fiscal_period": null,
        "line_items": null,
        "as_of": null
    },
    "period_count": 1,
    "periods": [
        {
            "fiscal_year": 2024,
            "fiscal_period": "FY",
            "period_start_date": "2024-01-01",
            "period_end_date": "2024-12-31",
            "statements": [
                {
                    "statement_type": "IS",
                    "statement_type_display": "Income Statement",
                    "currency": {
                        "code": "EUR",
                        "name": "Euro",
                        "symbol": "€"
                    },
                    "source_filing": {
                        "id": 32537845,
                        "filing_type": "10-K",
                        "release_datetime": "2025-03-15T10:00:00+00:00"
                    },
                    "extraction": {
                        "model": "gemini-2.5-flash@2026-05-19",
                        "prompt_version": "2026-05-19-v19-ebit-scale-cfs",
                        "extracted_at": "2026-05-20T08:00:00+00:00",
                        "notes": null
                    },
                    "sources": [
                        {
                            "filing_id": 32537845,
                            "filing_type": "10-K",
                            "release_datetime": "2025-03-15T10:00:00+00:00",
                            "is_selected": true
                        },
                        {
                            "filing_id": 31002211,
                            "filing_type": "ESEF",
                            "release_datetime": "2025-03-12T09:00:00+00:00",
                            "is_selected": false
                        }
                    ],
                    "line_items": [
                        {
                            "code": "revenue",
                            "name": "Total Revenues",
                            "statement_type": "IS",
                            "depth": 0,
                            "parent_code": null,
                            "sort_order": 10,
                            "value": "699767000.00",
                            "raw_value": "699767.000000",
                            "scale": "thousands",
                            "currency": "EUR",
                            "confidence": 0.98,
                            "source_page": 42
                        },
                        {
                            "code": "gross_profit",
                            "name": "Gross Profit",
                            "statement_type": "IS",
                            "depth": 0,
                            "parent_code": null,
                            "sort_order": 40,
                            "value": "571593000.00",
                            "raw_value": "571593.000000",
                            "scale": "thousands",
                            "currency": "EUR",
                            "confidence": 0.97,
                            "source_page": 42
                        }
                    ]
                }
            ]
        }
    ]
}

🟠400

🟠404