---
title: "Income Statement"
method: POST
path: "/v1/income-statement/query"
tags: ["Financials & Ratios"]
---

# Income Statement

`POST /v1/income-statement/query`

This endpoint retrieves fundamental income statement measures for a company, including revenue, expenses, and profitability metrics across reporting periods.

## Request body

- PublicIncomeStatementQuery
  - `identifier` SingleIdentifier, required
    - `type` 'rp_entity_id', required
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
  - `period` 'annual' | 'quarter'
  - `limit` integer, nullable — Maximum number of income statements records to return. If omitted, all income statements records are returned.

## Response `200`

Successful Response

- PublicIncomeStatementResponse
  - `results` union, required
    - IncomeStatement
      - `rp_entity_id` string, required — The RavenPack entity ID of the company.
      - `target_identifier_id` string, required — The target identifier ID of the company.
      - `fields` string[], required — The fields of the income statement (fixed list).
      - `values` array[], required — The values of the income statement.
        - unknown[]
          - unknown
    - object
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)