GET /v1/statements - 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?ticker=EXAMPLE&statement=income_statement&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 a normalized balance sheet, income statement, or cash flow statement for one issuer, with US GAAP and IFRS foreign-private-issuer resolution.

Audience: application and coding agent.

Coverage and source scope

Use this route to fetch one normalized statement for analysis or a financial-model input. Set statement and select annual or quarterly cadence, fiscal year, and a bounded history when the reporting slice matters. The response resolves supported US GAAP and IFRS filers, preserves reported units, periods, and filing provenance, and can contain missing or incomparable line items; it is not a substitute for the cited filing. See API conventions and freshness and source evidence.

Agent mode

Pass ?view=agent to receive the compact agent shape: rows + periods with tag, value, and period metadata. Provenance, completeness, freshness, materialization, and validation envelopes are dropped. See api conventions → response formats for the full ?view= contract.

Choose the statement and period

Supply one issuer identifier. Set statement when the workflow needs one statement type, then use period, fy / year, or a fiscal-year range to anchor the requested reporting slice. The route resolves US GAAP 10-K / 10-Q filers and, when applicable, IFRS foreign private issuers through ifrs-full 20-F / 6-K coverage. Read the returned periods, provenance, completeness, freshness, and materialization metadata alongside the rows. A missing normalized line item is not equivalent to zero, and values from different units, periods, or filing scopes should not be combined without normalization.

Financial statements API guide

Use statement data with explicit reporting-period context.

Coverage and depth

Understand source coverage and availability boundaries.

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?ticker=EXAMPLE&statement=income_statement&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 one issuer identifier and a supported statement selector when requesting a specific statement type
do not treat an absent normalized row as zero or use it to infer an unavailable disclosure
preserve provenance, completeness, freshness, materialization, requestId, and traceparent when handling a partial or transient result

Statements GET /v1/statements/{statement_key}

​Coverage and source scope

​Agent mode

​Choose the statement and period

​Related guides

Financial statements API guide

Coverage and depth

​Canonical metadata

​Example request

​Example response

​About this example

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Agent mode

Choose the statement and period

Related guides

Canonical metadata

Example request

Example response

About this example

Give this prompt to your agent

Failure posture