> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/statements/all

> Retrieve an issuer's normalized balance sheet, income statement, and cash flow statement together, with US GAAP and IFRS foreign-private-issuer resolution.

Retrieve an issuer's normalized balance sheet, income statement, and cash flow statement together, with US GAAP and IFRS foreign-private-issuer resolution.

<Info>
  Audience: application and coding agent.
</Info>

## Coverage and source scope

Use this route to obtain the three core statements for a common issuer and reporting selection. Choose annual or quarterly cadence and fiscal-year filters before comparing periods. Each statement retains its own rows, units, periods, completeness, and filing provenance, so a bundle does not guarantee that every normalized line item is available or comparable across all three statements. See [API conventions](/api-conventions) and [freshness and source evidence](/freshness-and-trust).

## Bundle interpretation

Supply one issuer identifier and use `period`, `fy` / `year`, or a fiscal-year range to bound the bundle. The response contains the balance sheet, income statement, and cash flow statement as separate normalized surfaces; align rows by their returned reporting periods rather than assuming the same number of observations in each statement.

The route resolves US GAAP 10-K / 10-Q filers and IFRS foreign private issuers through `ifrs-full` 20-F / 6-K coverage. Preserve per-statement provenance, completeness, freshness, and materialization metadata when storing or comparing the bundle.

## Related guides

<CardGroup cols={2}>
  <Card title="Financial statements API guide" icon="table-properties" href="/seo/sec-financial-statements-api">Choose normalized statement data for a filing-aware financial workflow.</Card>
  <Card title="XBRL API guide" icon="braces" href="/seo/xbrl-api">Review XBRL concepts and source provenance.</Card>
</CardGroup>

## Canonical metadata

* `requestId`
* `traceparent`
* `provenance`
* `freshness`
* `materialization`

## Example request

<RequestExample>
  ```bash theme={null}
  curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/statements/all?ticker=EXAMPLE&fy=2025"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "statement_bundle",
    "id": "stmt_bundle_example_2025",
    "createdAt": "2026-02-20T00:00:00.000Z",
    "livemode": false,
    "entityId": "ent_example",
    "ticker": "EXAMPLE",
    "companyName": "Example Issuer, Inc.",
    "period": "annual",
    "statements": {
      "balanceSheet": {
        "object": "statement",
        "id": "stmt_example_balance_sheet_2025",
        "createdAt": "2026-02-20T00:00:00.000Z",
        "livemode": false,
        "entityId": "ent_example",
        "ticker": "EXAMPLE",
        "companyName": "Example Issuer, Inc.",
        "statementKey": "balance_sheet",
        "title": "Balance Sheet",
        "period": "annual",
        "periods": [
          {
            "periodEnd": "2025-12-31",
            "filedAt": "2026-02-20",
            "form": "10-K",
            "fy": 2025,
            "fp": "FY"
          }
        ],
        "rows": [
          {
            "key": "cash_and_equivalents",
            "tag": "CashAndCashEquivalentsAtCarryingValue",
            "taxonomy": "us-gaap",
            "label": "Cash and cash equivalents",
            "unit": "USD",
            "values": [
              {
                "periodEnd": "2025-12-31",
                "filedAt": "2026-02-20",
                "form": "10-K",
                "fy": 2025,
                "fp": "FY",
                "periodStart": "2025-01-01",
                "value": 45678901,
                "periodBasis": "instant"
              }
            ]
          }
        ],
        "provenance": {
          "source": "example",
          "sourceLabel": "Illustrative response - not a live SEC filing",
          "accessionNumber": null,
          "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
          "retrievedAt": "2026-02-20T00:00:00.000Z",
          "parserVersion": "example"
        },
        "completeness": {
          "source": "company_facts",
          "observationsReturned": 1,
          "hasResolvedConcept": true
        },
        "freshness": {
          "status": "archival",
          "asOf": "2026-02-20T00:00:00.000Z",
          "sourcePublishedAt": "2026-02-20T00:00:00.000Z",
          "lagMs": 0
        },
        "materialization": {
          "parserVersion": "example",
          "materializationVersion": "example"
        }
      },
      "incomeStatement": {
        "object": "statement",
        "id": "stmt_example_income_statement_2025",
        "createdAt": "2026-02-20T00:00:00.000Z",
        "livemode": false,
        "entityId": "ent_example",
        "ticker": "EXAMPLE",
        "companyName": "Example Issuer, Inc.",
        "statementKey": "income_statement",
        "title": "Income Statement",
        "period": "annual",
        "periods": [
          {
            "periodEnd": "2025-12-31",
            "filedAt": "2026-02-20",
            "form": "10-K",
            "fy": 2025,
            "fp": "FY"
          }
        ],
        "rows": [
          {
            "key": "revenue",
            "tag": "Revenues",
            "taxonomy": "us-gaap",
            "label": "Revenue",
            "unit": "USD",
            "values": [
              {
                "periodEnd": "2025-12-31",
                "filedAt": "2026-02-20",
                "form": "10-K",
                "fy": 2025,
                "fp": "FY",
                "periodStart": "2025-01-01",
                "value": 123456789,
                "periodBasis": "fiscal_year_to_date"
              }
            ]
          }
        ],
        "provenance": {
          "source": "example",
          "sourceLabel": "Illustrative response - not a live SEC filing",
          "accessionNumber": null,
          "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
          "retrievedAt": "2026-02-20T00:00:00.000Z",
          "parserVersion": "example"
        },
        "completeness": {
          "source": "company_facts",
          "observationsReturned": 1,
          "hasResolvedConcept": true
        },
        "freshness": {
          "status": "archival",
          "asOf": "2026-02-20T00:00:00.000Z",
          "sourcePublishedAt": "2026-02-20T00:00:00.000Z",
          "lagMs": 0
        },
        "materialization": {
          "parserVersion": "example",
          "materializationVersion": "example"
        }
      },
      "cashFlowStatement": {
        "object": "statement",
        "id": "stmt_example_cash_flow_statement_2025",
        "createdAt": "2026-02-20T00:00:00.000Z",
        "livemode": false,
        "entityId": "ent_example",
        "ticker": "EXAMPLE",
        "companyName": "Example Issuer, Inc.",
        "statementKey": "cash_flow_statement",
        "title": "Cash Flow Statement",
        "period": "annual",
        "periods": [
          {
            "periodEnd": "2025-12-31",
            "filedAt": "2026-02-20",
            "form": "10-K",
            "fy": 2025,
            "fp": "FY"
          }
        ],
        "rows": [
          {
            "key": "operating_cash_flow",
            "tag": "NetCashProvidedByUsedInOperatingActivities",
            "taxonomy": "us-gaap",
            "label": "Net cash from operating activities",
            "unit": "USD",
            "values": [
              {
                "periodEnd": "2025-12-31",
                "filedAt": "2026-02-20",
                "form": "10-K",
                "fy": 2025,
                "fp": "FY",
                "periodStart": "2025-01-01",
                "value": 23456789,
                "periodBasis": "fiscal_year_to_date"
              }
            ]
          }
        ],
        "provenance": {
          "source": "example",
          "sourceLabel": "Illustrative response - not a live SEC filing",
          "accessionNumber": null,
          "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
          "retrievedAt": "2026-02-20T00:00:00.000Z",
          "parserVersion": "example"
        },
        "completeness": {
          "source": "company_facts",
          "observationsReturned": 1,
          "hasResolvedConcept": true
        },
        "freshness": {
          "status": "archival",
          "asOf": "2026-02-20T00:00:00.000Z",
          "sourcePublishedAt": "2026-02-20T00:00:00.000Z",
          "lagMs": 0
        },
        "materialization": {
          "parserVersion": "example",
          "materializationVersion": "example"
        }
      }
    },
    "provenance": {
      "source": "example",
      "sourceLabel": "Illustrative response - not a live SEC filing",
      "accessionNumber": null,
      "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
      "retrievedAt": "2026-02-20T00:00:00.000Z",
      "parserVersion": "example"
    },
    "freshness": {
      "status": "archival",
      "asOf": "2026-02-20T00:00:00.000Z",
      "sourcePublishedAt": "2026-02-20T00:00:00.000Z",
      "lagMs": 0
    },
    "materialization": {
      "parserVersion": "example",
      "materializationVersion": "example"
    },
    "requestId": "req_2ZK8Q1W9F4M6P7R3",
    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
  }
  ```
</ResponseExample>

## About this example

This response is illustrative: `EXAMPLE`, all IDs, amounts, and `example.com` URLs are synthetic. It shows the response shape only and does not identify or claim a live SEC filing.

## Give this prompt to your agent

<Prompt>
  Use SEC API GET /v1/statements/all to retrieve an issuer's normalized balance sheet, income statement, and cash flow statement together. Supply one issuer identifier and use period or fiscal-year filters to anchor the requested reporting slice. Preserve every statement's rows, periods, provenance, completeness, freshness, materialization, `requestId`, and `traceparent`; do not assume every issuer or filing period supplies every normalized line item.
</Prompt>

## Failure posture

* provide one issuer identifier before requesting a bundle
* do not assume each statement has the same reporting periods or every normalized line item
* preserve each statement's provenance, completeness, freshness, materialization, `requestId`, and `traceparent` when handling a partial or transient result
