GET /v3/filings/{accession}/facts
Every XBRL fact of a filing as filed: every instance read (the SEC-extracted one when there is one, else the filer's), facts numbered across them in reading order, each with its concept, context (entity, period, dimensions), unit, the exact value beside the filed text, decimals as filed (INF kept), nil, its duplicate class, and footnotes. A text block's content is not served: its span in the stored instance is. The xbrl block has the instances, taxonomy years, counts and dei cover values. Keyset pagination on fact_seq. 404 not_covered for a form under which no instance is filed.
API key: required. See Authentication.
Group: 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). | |
concept | query | comma-separated list of string | no | Only these concepts, as prefix:LocalName (standard taxonomies by their usual prefix: us-gaap, dei, ifrs-full, srt, ...). | |
limit | query | integer | no | 1000 | Page size, 1..5000. |
cursor | query | string | no | Opaque cursor from a previous page's next_cursor. |
Responses
| Status | Body | Description |
|---|---|---|
200 | XbrlFilingFacts (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | 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 (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a XbrlFilingFacts object.
| Field | Type | Required | Description |
|---|---|---|---|
accession | string | yes | |
data | array of XbrlFact | yes | |
extraction | Extraction | yes | |
filing | FilingRef | yes | |
footnotes | array of object | yes | |
has_more | boolean | yes | |
next_cursor | string | null | yes | |
snapshot | Snapshot | yes | |
xbrl | object | null | yes | The instances read, namespaces, taxonomy years, counts, dei cover values as filed, cover (registrants, securities, shares outstanding, public float, auditors), flags; null before a parse. |
Example request
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001829126-26-010431/facts'Open this route in the console
More in Financial data (XBRL)
Previous: GET /v3/companies/{cik}/statements · Next: GET /v3/filings/{accession}/statements
Markdown version: /docs/reference/get-filings-accession-facts.md