Skip to content

GET /v3/companies/{cik_or_ticker}/income-statement

Get a company's income statement by period.

Periods are fiscal years, quarters, or trailing twelve months. You get standardized fields in a fixed order, as line_items {concept, label, unit, accuracy, values[]}. Each value has its period, status, source filing (accession_number, form_type, filing_date) and, when derived (Q4 = FY - 9M, ttm = the four quarters), its formula. A blank is never a zero. A line with no value in the periods is left out. accuracy gives the field's measured precision and coverage.

API key: required. See Authentication.

Group: Financial data (XBRL)

Try it

Parameters

The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.

annual, quarterly (reported or derived quarters) or ttm (trailing twelve months at each quarter end; money lines only).

Periods, newest first, 1 to 200.

More parameters (1)

Point in time: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day.

Without a key the API answers 401; you can still send the request to see that.
Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/income-statement",
    params={"period": "annual", "limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Response

Nothing has been sent yet.

Parameters

NameInTypeRequiredDefaultDescription
cik_or_tickerpathstringyesThe company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.
periodquerystringnoannualannual, quarterly (reported or derived quarters) or ttm (trailing twelve months at each quarter end; money lines only). One of: annual, quarterly, ttm.
limitqueryintegerno8Periods, newest first, 1 to 200.
as_ofquerystringnoPoint in time: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day.

Responses

StatusBodyDescription
200SimpleStatement (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (application/problem+json)Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a SimpleStatement object.

FieldTypeRequiredDescription
as_ofstring | nullyes
basisstringyesHow the accuracy numbers were measured.
cikstringyes
excludedExcludedyes
excluded_totalintegeryes
has_morebooleanyesTrue when periods older than the oldest one returned exist.
limitintegeryes
line_itemsarray of SimpleStatementLineyesThe lines in the statement's fixed order. A line with no value in any period is left out.
mapobjectyes
periodstringyesOne of: annual, quarterly, ttm.
statementstringyesOne of: balance_sheet, income_statement, cash_flow.

Example request

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/income-statement",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Example answer

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/income-statement",
    params={"period": "annual", "limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
JSON
{
  "as_of": null,
  "basis": "per field, its set: holdout-5 (the core 15), holdout-6 (the full template's further fields) or holdout-7 (sga, selling_marketing, general_administrative under map full-1.1.0), 300 company-year cells each never used to write the rules, values checked against SEC's R pages; precision = correct / serve…(truncated)",
  "cik": "0000320193",
  "excluded": [],
  "excluded_total": 0,
  "has_more": true,
  "limit": 2,
  "line_items": [
    {
      "accuracy": {
        "correct": 276,
        "coverage_pct": 92,
        "precision_pct": 100,
        "served": 276,
        "set": "holdout-5"
      },
      "concept": "revenue",
      "label": "Revenue",
      "unit": "iso4217:USD",
      "values": [
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2026,
          "form_type": "10-K",
          "period_end": "2026-09-26",
          "period_start": "2025-09-28",
          "source": "reported",
          "status": "ok",
          "value": "478834000000"
        },
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2025,
          "form_type": "10-K",
          "period_end": "2025-09-27",
          "period_start": "2024-09-29",
          "source": "reported",
          "status": "ok",
          "value": "416161000000"
        }
      ]
    },
    {
      "accuracy": {
        "correct": 163,
        "coverage_pct": 54.3,
        "precision_pct": 100,
        "served": 163,
        "set": "holdout-5"
      },
      "concept": "cost_of_revenue",
      "label": "Cost of revenue",
      "unit": "iso4217:USD",
      "values": [
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2026,
          "form_type": "10-K",
          "period_end": "2026-09-26",
          "period_start": "2025-09-28",
          "source": "reported",
          "status": "ok",
          "value": "245232000000"
        },
        {
          "accession_number": "0000320193-26-000026",
          "filing_date": "2026-11-03",
          "fiscal_period": "FY",
          "fiscal_year": 2025,
          "form_type": "10-K",
          "period_end": "2025-09-27",
          "period_start": "2024-09-29",
          "source": "reported",
          "status": "ok",
          "value": "220960000000"
        }
      ]
    }
  ],
  "map": {
    "fingerprint": "ade632e382bf0a76c5b99dc3c7e693d0cb41378812323adf61b635f865680895",
    "version": "full-1.1.0"
  },
  "period": "annual",
  "statement": "income_statement",
  "resolved": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "ticker_file_date": "2026-11-18"
  }
}

More in Financial data (XBRL)

Previous: GET /v3/companies/{cik_or_ticker}/cash-flow · Next: GET /v3/companies/{cik_or_ticker}/periods

Markdown version: /docs/reference/get-companies-cik-or-ticker-income-statement.md