Skip to content

GET /v3/filings/{accession}/statements/roles

The filing's roles without their statements: every role (statements, cover, notes, policies, tables, details) in position order, with its menu category, statement kind, R page, tree size and matches_sec_render, and a link to its statement. 404 not_covered for a form under which no XBRL is filed. Paged by role number: 500 a page, has_more and next_cursor.

API key: required. See Authentication.

Group: Financial data (XBRL)

Parameters

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).
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).
limitqueryintegerno500Roles per page, 1..500.
cursorquerystringnonext_cursor of the previous page (same filters).

Responses

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

FieldTypeRequiredDescription
accessionstringyes
categorystring | nullyes
dataarray of XbrlRoleyesRole number order, at most 500 a page.
extractionExtractionyes
filingFilingRefyes
has_morebooleanyes
next_cursorstring | nullyes
snapshotSnapshotyes
xbrl_statementsobject | nullyes

Example request

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

Open this route in the console

More in Financial data (XBRL)

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

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