Skip to content

GET /v3/companies/{cik_or_ticker}/statements

Get a company's latest statement as presented.

From its latest periodic report (10-K, 10-Q, 10-KT, 10-QT, 20-F, 40-F, or an amendment) accepted by as_of. Ask by kind (with its parenthetical statements), by menu category (such as notes) or by role URI. limit above 1 adds earlier reports, newest first.

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.

Statement kind: BS, IS, CF, EQ, CI, CP, or UN. Required unless category or role_uri is given.

Reports, 1 to 8 (1 with a category alone).

More parameters (4)

Menu category as in SEC's FilingSummary, any letter case: Cover, Statements, Notes, Policies, Tables, Details, Other, or Uncategorized.

Only the role with this URI (roles[].role_uri), such as a company's own detail role.

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.

next_cursor from the previous page (a category alone). Use the same filters.

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/statements",
    params={"kind": "IS", "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.
kindquerystringnoStatement kind: BS, IS, CF, EQ, CI, CP, or UN. Required unless category or role_uri is given. One of: BS, IS, CF, EQ, CI, CP, UN.
categoryquerystringnoMenu category as in SEC's FilingSummary, any letter case: Cover, Statements, Notes, Policies, Tables, Details, Other, or Uncategorized.
role_uriquerystringnoOnly the role with this URI (roles[].role_uri), such as a company's own detail role.
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.
limitqueryintegerno1Reports, 1 to 8 (1 with a category alone).
cursorquerystringnonext_cursor from the previous page (a category alone). Use the same filters.

Details

Paging: each report's statements page as on /v3/filings/{accession}/statements; links.next continues there. A category without kind or role_uri gives one report (limit 1), whose roles page here with next_cursor. Deleted reports are skipped (the previous report is served) and listed in excluded.

Responses

StatusBodyDescription
200XbrlCompanyStatements (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).
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 XbrlCompanyStatements object.

FieldTypeRequiredDescription
as_ofstring | nullyes
categorystring | nullyes
cikstringyes
dataarray of objectyes
data[].accessionstringno
data[].filingobjectnoThe report's filing. links.next, when present, points to the next page of this report on the filing's route.
data[].has_morebooleanno
data[].statementsarray of XbrlStatementno
excludedExcludedyes
excluded_totalintegeryes
has_morebooleanyesTrue when more pages follow. When you ask for a category alone, the next page holds the report's next roles.
kindstring | nullyes
next_cursorstring | nullyes
role_uristring | nullyes

Example request

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/statements",
    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/statements",
    params={"kind": "IS", "limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
JSON
{
  "as_of": null,
  "category": null,
  "cik": "0000320193",
  "data": [
    {
      "accession": "0000320193-26-000026",
      "filing": {
        "accepted_at": "2026-11-03T13:05:15Z",
        "filing_date": "2026-11-03",
        "form_type": "10-K",
        "links": {
          "self": "/v3/filings/0000320193-26-000026",
          "statements": "/v3/filings/0000320193-26-000026/statements"
        },
        "period_of_report": "2026-09-26"
      },
      "has_more": false,
      "statements": [
        {
          "calculation": [
            {
              "child": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
              "order": "1",
              "order_raw": "1",
              "parent": "us-gaap:GrossProfit",
              "weight": "1.0",
              "weight_raw": "1.0"
            },
            {
              "child": "us-gaap:CostOfGoodsAndServicesSold",
              "order": "2",
              "order_raw": "2",
              "parent": "us-gaap:GrossProfit",
              "weight": "-1.0",
              "weight_raw": "-1.0"
            }
          ],
          "columns": [
            {
              "days": 364,
              "is_document_period": true,
              "period": {
                "end": "2026-09-26",
                "start": "2025-09-28",
                "type": "duration"
              }
            },
            {
              "days": 364,
              "is_document_period": false,
              "period": {
                "end": "2025-09-27",
                "start": "2024-09-29",
                "type": "duration"
              }
            }
          ],
          "layout": {
            "kind": "tree",
            "rows": [
              {
                "column": null,
                "members": null,
                "seq": 8
              },
              {
                "column": null,
                "members": null,
                "seq": 9
              }
            ]
          },
          "links": {
            "facts": "/v3/filings/0000320193-26-000026/facts"
          },
          "matches_sec_render": true,
          "role": {
            "kind_method": "name_rule:is_operations",
            "long_name": "9952151 - Statement - CONSOLIDATED STATEMENTS OF OPERATIONS",
            "menu_category": "Statements",
            "parenthetical": false,
            "r_page": "R3.htm",
            "role_no": 3,
            "role_uri": "http://www.apple.com/role/CONSOLIDATEDSTATEMENTSOFOPERATIONS",
            "short_name": "CONSOLIDATED STATEMENTS OF OPERATIONS",
            "statement_kind": "IS"
          },
          "rows": [
            {
              "cells": [
                null,
                null
              ],
              "concept": "us-gaap:IncomeStatementAbstract",
              "depth": 0,
              "is_abstract": true,
              "is_period_end": false,
              "is_period_start": false,
              "is_total": false,
              "label": "Income Statement [Abstract]",
              "members_only": false,
              "negating": false,
              "parent_seq": 0,
              "preferred_label_role": null,
              "seq": 1,
              "structure": null
            },
            {
              "cells": [
                null,
                null
              ],
              "concept": "us-gaap:StatementTable",
              "depth": 1,
              "is_abstract": true,
              "is_period_end": false,
              "is_period_start": false,
              "is_total": false,
              "label": "Statement [Table]",
              "members_only": false,
              "negating": false,
              "parent_seq": 1,
              "preferred_label_role": "http://www.xbrl.org/2003/role/terseLabel",
              "seq": 2,
              "structure": "table"
            }
          ],
          "rows_from_seq": 1,
          "rows_has_more": false,
          "warnings": []
        }
      ]
    },
    {
      "accession": "0000320193-26-000020",
      "filing": {
        "accepted_at": "2026-07-31T14:01:02Z",
        "filing_date": "2026-07-31",
        "form_type": "10-Q",
        "links": {
          "self": "/v3/filings/0000320193-26-000020",
          "statements": "/v3/filings/0000320193-26-000020/statements"
        },
        "period_of_report": "2026-06-27"
      },
      "has_more": false,
      "statements": [
        {
          "calculation": [
            {
              "child": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
              "order": "1",
              "order_raw": "1",
              "parent": "us-gaap:GrossProfit",
              "weight": "1.0",
              "weight_raw": "1.0"
            },
            {
              "child": "us-gaap:CostOfGoodsAndServicesSold",
              "order": "2",
              "order_raw": "2",
              "parent": "us-gaap:GrossProfit",
              "weight": "-1.0",
              "weight_raw": "-1.0"
            }
          ],
          "columns": [
            {
              "days": 91,
              "is_document_period": true,
              "period": {
                "end": "2026-06-27",
                "start": "2026-03-29",
                "type": "duration"
              }
            },
            {
              "days": 273,
              "is_document_period": true,
              "period": {
                "end": "2026-06-27",
                "start": "2025-09-28",
                "type": "duration"
              }
            }
          ],
          "layout": {
            "kind": "tree",
            "rows": [
              {
                "column": null,
                "members": null,
                "seq": 8
              },
              {
                "column": null,
                "members": null,
                "seq": 9
              }
            ]
          },
          "links": {
            "facts": "/v3/filings/0000320193-26-000020/facts"
          },
          "matches_sec_render": true,
          "role": {
            "kind_method": "name_rule:is_operations",
            "long_name": "9952151 - Statement - CONDENSED CONSOLIDATED STATEMENTS OF OPERATIONS (Unaudited)",
            "menu_category": "Statements",
            "parenthetical": false,
            "r_page": "R2.htm",
            "role_no": 2,
            "role_uri": "http://www.apple.com/role/CONDENSEDCONSOLIDATEDSTATEMENTSOFOPERATIONSUnaudited",
            "short_name": "CONDENSED CONSOLIDATED STATEMENTS OF OPERATIONS (Unaudited)",
            "statement_kind": "IS"
          },
          "rows": [
            {
              "cells": [
                null,
                null
              ],
              "concept": "us-gaap:IncomeStatementAbstract",
              "depth": 0,
              "is_abstract": true,
              "is_period_end": false,
              "is_period_start": false,
              "is_total": false,
              "label": "Income Statement [Abstract]",
              "members_only": false,
              "negating": false,
              "parent_seq": 0,
              "preferred_label_role": null,
              "seq": 1,
              "structure": null
            },
            {
              "cells": [
                null,
                null
              ],
              "concept": "us-gaap:StatementTable",
              "depth": 1,
              "is_abstract": true,
              "is_period_end": false,
              "is_period_start": false,
              "is_total": false,
              "label": "Statement [Table]",
              "members_only": false,
              "negating": false,
              "parent_seq": 1,
              "preferred_label_role": "http://www.xbrl.org/2003/role/terseLabel",
              "seq": 2,
              "structure": "table"
            }
          ],
          "rows_from_seq": 1,
          "rows_has_more": false,
          "warnings": []
        }
      ]
    }
  ],
  "excluded": [],
  "excluded_total": 0,
  "has_more": false,
  "kind": "IS",
  "next_cursor": null,
  "role_uri": null,
  "resolved": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "ticker_file_date": "2026-11-18"
  }
}

More in Financial data (XBRL)

Previous: GET /v3/companies/{cik_or_ticker}/standard · Next: GET /v3/filings/{accession}/facts

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