# 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](https://www.secblast.com/docs/authentication).

**Group:** [Financial data (XBRL)](https://www.secblast.com/docs/reference#financial-data-xbrl)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `accession` | path | string | yes |   | Accession number, with dashes (0001829126-26-010431) or without (18 digits). |
| `kind` | query | string | no |   | The 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`. |
| `category` | query | string | no |   | The 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_no` | query | integer | no |   | Only this role (v3 role number, from roles\[\].role_no). |
| `role_uri` | query | string | no |   | Only the role with this URI (roles\[\].role_uri), e.g. a company's own detail role. |
| `limit` | query | integer | no | `25` | Roles per page, 1..25. |
| `cursor` | query | string | no |   | next_cursor of the previous page (same filters). |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [XbrlFilingStatements](https://www.secblast.com/docs/reference/schemas#schema-xbrlfilingstatements) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [XbrlFilingStatements](https://www.secblast.com/docs/reference/schemas#schema-xbrlfilingstatements) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `accession` | string | yes |   |
| `data` | array of [XbrlStatement](https://www.secblast.com/docs/reference/schemas#schema-xbrlstatement) | yes | At most 25 roles (limit) and 2 MB of statement JSON a page. |
| `extraction` | [Extraction](https://www.secblast.com/docs/reference/schemas#schema-extraction) | yes |   |
| `filing` | [FilingRef](https://www.secblast.com/docs/reference/schemas#schema-filingref) | yes |   |
| `has_more` | boolean | yes |   |
| `next_cursor` | string \| null | yes |   |
| `roles` | array of object \| null | yes | The 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_more` | boolean | yes |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes |   |
| `xbrl_statements` | object \| null | yes | Metadata source, documents read, counts, flags; null before a parse. |

## Example request

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

[Open this route in the console](https://www.secblast.com/console#get-v3-filings-accession-statements)

## More in Financial data (XBRL)

Previous: [`GET /v3/filings/{accession}/facts`](https://www.secblast.com/docs/reference/get-filings-accession-facts) · Next: [`GET /v3/filings/{accession}/statements/roles`](https://www.secblast.com/docs/reference/get-filings-accession-statements-roles)
