Skip to content
English
Back to the main page
  • There are no suggestions because the search field is empty.

How can I tell whether financials are actual or estimated?

This article explains how to see whether financial values are actual reported figures or estimates in the Data Service API and exports.

Overview

North Data distinguishes between:

  • Actual values: officially reported figures from financial statements, publications, or other reliable sources.

  • Estimated values: model-based figures.

To help you interpret financial data correctly, estimated values are clearly flagged in the API and in JSON exports.

1) Data Service API

In the API response, each financial record includes an estimate field within the financials object.

Field path
financials -> estimate

Type
Boolean: true or false

Meaning

  • estimate: true → the financial value is estimated

  • estimate: false → the financial value is actual / reported

Example (simplified JSON)

financials": {
        "consolidated": false,
        "date": "2022-01-31",
        "formattedDate": "31/01/2022",
        "items": [
            {
                "estimate": false,
                "formattedValue": "€61.1M",
                "id": "BalanceTotal",
                "name": "Total assets",
                "note": "",
                "unit": "EUR",
                "value": 6.106239616E7
            },
            {
                "estimate": false,
                "formattedValue": "€2,636,381",
                "id": "Earnings",
                "name": "Earnings",
                "note": "German HGB \"Jahresüberschuß\"",
                "unit": "EUR",
                "value": 2636381.25
            },
            {
                "estimate": false,
                "formattedValue": "€75.9M",
                "id": "Revenue",
                "name": "Revenue",
                "note": "",
                "unit": "EUR",
                "value": 7.592452522E7
            },

2) Dataset exports

The same estimate field is also available in dataset exports — but only in the JSON export.

JSON export

  • Includes the estimate boolean for each financial record.

  • Meaning is exactly the same as in the API.

CSV export

  • Does not include an estimate field.

  • Therefore, you cannot directly distinguish actual vs. estimated values in CSV files.