GET /v1/statements/all - SEC API for AI

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"

{
  "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"
}

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

Audience: application and coding agent.

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 and freshness and source evidence.

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.

Financial statements API guide

Choose normalized statement data for a filing-aware financial workflow.

XBRL API guide

Review XBRL concepts and source provenance.

Canonical metadata

requestId
traceparent
provenance
freshness
materialization

Example request

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"

Example response

{
  "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"
}

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

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

GET /v1/statements/{statement_key}GET /v1/statements/segmented-facts

​Coverage and source scope

​Bundle interpretation

​Related guides

Financial statements API guide

XBRL API guide

​Canonical metadata

​Example request

​Example response

​About this example

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Bundle interpretation

Related guides

Canonical metadata

Example request

Example response

About this example

Give this prompt to your agent

Failure posture