GET /v3/filings/{accession}/parsed
Which parsed datasets apply to the filing (13f, 8k_items, sections) and the state of each: status (ok, ok_with_warnings, partial, unparseable, not_applicable; pending, failed or not_parsed while there is no result), the extractor version that last verified the filing and the deployed one, a re-parse in progress, warnings (at most 100), the documents read, the dataset's derive steps for the filing, and a link to the dataset's route for the filing (null while this server does not answer it). Empty data when no dataset covers the form. A parser failure is never a 5xx. Measured accuracy is not published. A filing SEC deleted (withdrew) is served like any other on every /v3/filings/{accession}/... parsed route: its parsed rows are kept and its filing block says status deleted, deleted_at and deletion (as GET /v3/filings/{accession}).
API key: required. See Authentication.
Group: Parsed data and tables
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
accession | path | string | yes | Accession number, with dashes (0001829126-26-010431) or without (18 digits). | |
dataset | query | comma-separated list of string | no | Only these datasets of the deployed parser (13f, 8k_items, sections); an unknown name is a 400. |
Responses
| Status | Body | Description |
|---|---|---|
200 | ParsedList (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 ParsedList object.
| Field | Type | Required | Description |
|---|---|---|---|
accession | string | yes | |
data | array of ParsedItem | yes | One per extractor that covers the filing's form type; empty when none does. |
filing | FilingRef | yes | |
has_more | boolean | yes | |
next_cursor | string | null | yes | |
snapshot | Snapshot | yes |
Example request
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001829126-26-010431/parsed'Open this route in the console
More in Parsed data and tables
Next: GET /v3/filings/{accession}/parsed/changes
Markdown version: /docs/reference/get-filings-accession-parsed.md