Skip to content

GET /v3/filings/{accession}/statements

The filing's statements as presented: every role of the filing (with its R page), and for the roles asked -- by default the statement and cover roles; kind, category, role_no or role_uri name others, notes, policies, tables and details included -- the presentation tree in the filer's order with preferred labels, negating / total / period start and end flags, its calculation arcs, and the columns and cells assembled from the filing's facts (each cell the filed fact: exact value and filed text; a blank is null, never zero; a text block's cell says where its text is). A negating label flips the displayed sign only: the cell is the fact as filed. matches_sec_render says whether the assembled layout has the rows of SEC's R page in its order (null: no R page). Paged: at most 25 roles and 2 MB of statements a page, a role longer than the rest of the page continues on the next one (rows_from_seq, rows_has_more); has_more and next_cursor; the role listing (roles, its first 500) on the first page only. 404 not_covered for a form under which no XBRL is filed.

API key: required. See Authentication.

Group: Financial data (XBRL)

Parameters

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).
kindquerystringnoThe statement kind: BS balance sheet, IS income statement, CF cash flow, EQ changes in equity, CI comprehensive income, CP cover page, UN a statement no name rule classifies. One of: BS, IS, CF, EQ, CI, CP, UN.
categoryquerystringnoThe role's menu category as SEC's FilingSummary states it, any letter case: Cover, Statements, Notes, Policies, Tables, Details, Other or Uncategorized (notes, policies, tables and details are served like statements).
role_noqueryintegernoOnly this role (v3 role number, from roles[].role_no).
role_uriquerystringnoOnly the role with this URI (roles[].role_uri), e.g. a company's own detail role.
limitqueryintegerno25Roles per page, 1..25.
cursorquerystringnonext_cursor of the previous page (same filters).

Responses

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

FieldTypeRequiredDescription
accessionstringyes
dataarray of XbrlStatementyesAt most 25 roles (limit) and 2 MB of statement JSON a page.
extractionExtractionyes
filingFilingRefyes
has_morebooleanyes
next_cursorstring | nullyes
rolesarray of object | nullyesThe filing's roles, role number order: on the first page (no cursor) only, its first 500 (the rest: /statements/roles); null on later pages.
roles_has_morebooleanyes
snapshotSnapshotyes
xbrl_statementsobject | nullyesMetadata source, documents read, counts, flags; null before a parse.

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001829126-26-010431/statements'

Open this route in the console

More in Financial data (XBRL)

Previous: GET /v3/filings/{accession}/facts · Next: GET /v3/filings/{accession}/statements/roles

Markdown version: /docs/reference/get-filings-accession-statements.md