Skip to content

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

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).
conceptquerycomma-separated list of stringnoOnly these concepts, as prefix:LocalName (standard taxonomies by their usual prefix: us-gaap, dei, ifrs-full, srt, ...).
limitqueryintegerno1000Page size, 1..5000.
cursorquerystringnoOpaque cursor from a previous page's next_cursor.

Responses

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

FieldTypeRequiredDescription
accessionstringyes
dataarray of XbrlFactyes
extractionExtractionyes
filingFilingRefyes
footnotesarray of objectyes
has_morebooleanyes
next_cursorstring | nullyes
snapshotSnapshotyes
xbrlobject | nullyesThe 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

Shell
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