---
title: "Company Financial Reports"
method: GET
path: "/v1/companies/{id}/financials"
tags: ["Companies", "v1"]
---

# Company Financial Reports

`GET /v1/companies/{id}/financials`

## Request

- Base URL: `https://api.leadfeeder.com`
- URL: `https://api.leadfeeder.com/v1/companies/{id}/financials`
- Auth: one of:
  - API key in header `X-Api-Key`
  - OAuth 2
    - Authorization code: `https://api.leadfeeder.com/v1/oauth/authorize`
    - Token URL: `https://api.leadfeeder.com/v1/oauth/token` scopes: `companies:read`

Returns all financial reports for a given company.
Credit Note: Accessing financial data consumes 1 credit per company only if financial data is available and there was no active deep data access within the last 12 months. Once charged, no additional credits are consumed for accessing the same company’s financial data again within that 12-month period.

:::info
Requires the `companies:read` OAuth2 scope.
:::

## Path parameters

- `id` string, required

## Query parameters

- `account_id` string, required

## Response `200`

Success

- object
  - `data` CompanyFinancialsV1[], required
    - `attributes` object, required
      - `available_indicators` object[], required: The available financial indicators for the given year.
        - `estimated` boolean, required: Whether the value is estimated.
        - `name` 'accounts_receivable' | 'balance_sheet_total' | 'cash_and_cash_equivalents' | 'creditors_after_one_year' | 'creditors_within_one_year' | 'current_assets' | 'debt' | 'earnings' | 'earnings_cagr' | 'employees' | 'equity' | 'equity_ratio' | 'fixed_assets' | 'issued_share_capital' | 'liabilities' | 'materials_expenditure' | 'net_current_assets' | 'operation_expenses' | 'operation_result' | 'pension_provisions' | 'real_estate_expenditures' | 'return_on_equity' | 'return_on_sales' | 'revenue' | 'revenue_cagr' | 'revenue_per_employee' | 'salaries_paid' | 'salaries_per_employee' | 'tax_paid' | 'tax_ratio' | 'total_assets_less_current_liabilities', required: The name of the financial indicator.
        - `type` union, required: The type of the financial indicator.
          - 'currency' | 'percentage' | 'number'
          - number
        - `unit` string, nullable, required: The unit of the value. `null` for unitless indicators, such as plain counts (`type: number`, e.g. `employees`).
        - `value` number, required: The value of the financial indicator.
      - `consolidated` boolean, required: Indicates if the financial indicators are consolidated.
      - `year` number, required: Which year the financial indicators are for.
    - `id` string, required
    - `type` 'company_financials', required: The type of the object
  - `meta` object, required
    - `credits` object, required
      - `charged` number, required: How many credits were consumed for this request.
    - `request_id` string, required: A unique identifier assigned to each API request for end-to-end traceability.

## Other responses

- `401`: Unauthorized. The request was rejected because the credentials are missing, invalid, expired, or have been revoked. The client must re-authenticate before retrying. Clients can differentiate via the `code` value of the first item in `errors`.
- `403`: Forbidden. The credentials are valid but the caller is not authorized to perform the request — typically because the user lacks the required permission, the OAuth scope is insufficient, the subscription plan does not include the required entitlement, the `account_id` does not belong to the authenticated user, or the target list is read-only and its members cannot be modified. Clients can differentiate via the `code` value of the first item in `errors`.
- `404`: Not found
- `429`: Too many requests. Either the per-second rate limit or the monthly quota configured for the API key / OAuth application has been exceeded. Clients can differentiate via the `code` value of the first item in `errors`.
- `500`: Internal server error
- `504`: Server timeout

## Changes

> 46 revisions in range; 1 not diffed.

- **2026-09-03** `ac752c6c2be0`: 6 info
  - added the optional property `errors/items/source` to the response with the `401` status
  - added the optional property `errors/items/source` to the response with the `403` status
  - added the optional property `errors/items/source` to the response with the `404` status
  - added the optional property `errors/items/source` to the response with the `429` status
  - …2 more
- **2026-08-27** `a84418574575`: 1 breaking
  - the response property `data/items/attributes/available_indicators/items/unit` became nullable for the status `200`
- **2026-07-13** `12ae8a6b9fad`: 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `OAuth2` was added to the API
  - added the non-success response with the status `401`

[Operation history](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/changes/v1/companies/:id/financials/get.md)

---

[API](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api.md) - [All operations](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/revisions/686d4e39eb05?raw)