GET /v1/statements/{statement_key}

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/statements/income_statement?ticker=EXAMPLE&fy=2025"

{
  "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"
  },
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Retrieve one normalized statement type for an issuer, with US GAAP and IFRS foreign-private-issuer resolution and optional fiscal-period filters.

Audience: application and coding agent.

Coverage and source scope

Use this route when the statement type belongs in the URL rather than a query string. Set statement_key to a supported normalized statement, then select annual or quarterly cadence and fiscal years as needed. The result preserves reported units, periods, and filing provenance and may contain missing or incomparable normalized line items. See API conventions and freshness and source evidence.

Required inputs

statement_key selects the normalized statement type; supply one issuer identifier and use period, fy / year, or a fiscal-year range when the workflow needs a particular reporting slice. Inspect the returned periods and provenance rather than inferring a fiscal period from the request alone.

Financial statements API guide

Understand normalized statement coverage and filing context.

Freshness and trust

Carry source and freshness metadata into downstream reports.

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/income_statement?ticker=EXAMPLE&fy=2025"

Example response

{
  "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"
  },
  "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 a supported statement_key and one issuer identifier
use the returned periods and provenance rather than inferring the reporting slice from a requested fiscal year alone
preserve completeness, freshness, materialization, requestId, and traceparent when handling a partial or transient result

GET /v1/statements GET /v1/statements/all

​Coverage and source scope

​Required inputs

​Related guides

Financial statements API guide

Freshness and trust

​Canonical metadata

​Example request

​Example response

​About this example

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Required inputs

Related guides

Canonical metadata

Example request

Example response

About this example

Give this prompt to your agent

Failure posture