---
title: "Balance Sheet"
method: POST
path: "/v1/balance-sheet/query"
tags: ["Financials & Ratios"]
---

# Balance Sheet

`POST /v1/balance-sheet/query`

This endpoint retrieves fundamental balance sheet measures for a company, including assets, liabilities, and equity across reporting periods.

## Request body

- PublicBalanceSheetQuery
  - `identifier` Identifier, required
    - `type` 'rp_entity_id', required
    - `value` union, 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`)
      - string
      - string[]
  - `period` 'annual' | 'quarter'
  - `limit` integer, nullable — Maximum number of balance sheets to return. If omitted, all balance sheets are returned.

## Response `200`

Successful Response

- PublicBalanceSheetResponse
  - `results` BalanceSheet, required
    - `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 balance sheet.
    - `values` array[], required — The values of the balance sheet.
      - union[]
        - union
          - string
          - integer
          - number
  - `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)