GET /v3/filings/{accession}
One filing with entities, documents, events and its version chain. A filing SEC deleted (withdrew) is served like any other: status deleted, deleted true, deleted_at and the deletion block; its documents when they were delivered (a filing known only from its deletion notice has none). accepted_at and period_of_report are the stored values (see the Filing schema: a header time wins over SEC's, SEC's reportDate over the header's period); accepted_at_snapshot gives SEC's time when it differs.
API key: required. See Authentication.
Group: Filings
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
accession | path | string | yes | Accession number, with dashes (0001829126-26-010431) or without (18 digits). |
Responses
| Status | Body | Description |
|---|---|---|
200 | FilingDetail (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 FilingDetail object.
| Field | Type | Required | Description |
|---|---|---|---|
accepted_at | date-time (RFC 3339, UTC) | null | no | The acceptance time stored in v3. A time from the filing's own header (source realtime or archives_txt) always wins over SEC's; once stored a time does not move (a later SEC value goes to accepted_at_snapshot). Otherwise SEC's submissions value: for a filing new since the previous snapshot sync, SEC's value minus the New York UTC offset (SEC's values carry that offset), source submissions_corrected; for history, SEC's value as given, source submissions_unverified (it may carry 0, 1 or 2 such offsets). Null when no source has a time. |
accepted_at_snapshot | date-time (RFC 3339, UTC) | no | Present only when SEC's submissions value differs from accepted_at (at whole seconds): SEC's value as given. |
accepted_at_source | string | null | no | realtime / archives_txt: from the filing's header (live ingest / SEC Archives). submissions_corrected, submissions_unverified: from SEC's submissions snapshot (see accepted_at). oldload and submissions are not written any more. One of: realtime, archives_txt, submissions_corrected, submissions_unverified, oldload, submissions, null. |
accession | string | yes | |
base_form | string | yes | |
deleted_at | date-time (RFC 3339, UTC) | null | no | |
doc_count | integer | no | |
feed_date | date (YYYY-MM-DD) | null | no | |
filing_date | date (YYYY-MM-DD) | yes | |
first_seen_at | date-time (RFC 3339, UTC) | null | no | |
form_type | string | yes | Form type as filed. |
header_in_file | boolean | no | Single filing only. false: SEC's submission file of the filing has no SGML header (part of the 1994-1995 Archives files hold only their documents); its form type, filing date and filers are SEC's submissions index values, links.header is null and /header answers 404 with reason no_header_in_file. |
is_amendment | boolean | yes | |
is_inline_xbrl | boolean | null | no | SEC's isInlineXBRL; null as is_xbrl. |
is_xbrl | boolean | null | no | SEC's isXBRL; null when SEC does not say or the snapshot sync has not seen the filing. |
items | array of string | no | |
items_unmapped | array of string | no | |
links | object | yes | |
links.documents | string | no | |
links.events | string | no | |
links.header | string | null | no | null when header_in_file is false (single filing). |
links.self | string | no | |
period_of_report | date (YYYY-MM-DD) | null | no | SEC's reportDate (submissions snapshot) when it gives one, otherwise the value in the filing's header. |
period_of_report_header | date (YYYY-MM-DD) | null | no | Single filing only, and only when SEC's reportDate replaced a different header period: the header's (null: the header has none). |
period_of_report_source | string | null | no | One of: submissions, header, null. |
primary_cik | string | yes | |
primary_name | string | null | no | Name of the primary entity as filed (header_in_file false: the name SEC's submissions index gives for the filing date, or null). |
provisional | boolean | no | status == provisional. |
sec_items | array of string | null | no | SEC's 8-K items list (items is the header's); null when the snapshot sync has not seen the filing. |
sec_primary_doc_description | string | null | no | Single filing only: SEC's primaryDocDescription. |
sec_primary_document | string | null | no | SEC's primaryDocument (file name). |
sec_url | string (URI) | yes | |
snapshot_date | date (YYYY-MM-DD) | null | no | Single filing only: the snapshot whose values were last written to the filing; null when none was. |
source | string | no | realtime: registered by live ingest; it becomes feed when the nightly feed delivers the filing. One of: feed, oldload, archives, realtime. |
status | string | yes | provisional: registered by live ingest and not yet confirmed by the nightly feed, which makes it final (and may replace its documents). deleted: SEC deleted (withdrew) the filing; it is still served, with its documents when they were delivered (deleted_at, and the deletion block on the single filing). One of: provisional, final, deleted. |
total_bytes | integer | no | |
date_of_change | date (YYYY-MM-DD) | null | no | |
deleted | boolean | no | status == deleted. |
deletion | object | null | no | Only for a deleted filing (null otherwise): where the deletion came from. SEC's DELETION notice gives no reason. |
deletion.feed_date | date (YYYY-MM-DD) | null | no | The feed day whose archive held the notice. |
deletion.notice | string | null | no | The notice member, <archive>#<member>. |
deletion.recorded_at | date-time (RFC 3339, UTC) | null | no | When v3 registered the deletion. |
deletion.source | string | null | no | Where the deletion notice came from, as the filing's events say it: feed (SEC's nightly feed, which carries the notices) for every deletion today. |
documents | array of Document | no | |
effectiveness_date | date (YYYY-MM-DD) | null | no | |
entities | array of FilingEntity | no | |
events | array of Event | no | |
finalized_at | date-time (RFC 3339, UTC) | null | no | |
is_correction | boolean | no | |
is_paper | boolean | no | |
is_private_release | boolean | no | |
live | object | no | Only while the filing is provisional and its source is realtime: where live ingest is with it. Gone once the filing is final. |
live.documents_at | date-time (RFC 3339, UTC) | null | no | When its documents were registered; null until then. |
live.listed_at | date-time (RFC 3339, UTC) | null | no | When the filing was listed. |
live.state | string | no | listed: the header is registered (entities, items, acceptance time, /header); doc_count is 0 and the documents are still being fetched. complete: the documents are registered. documents_failed: they could not be fetched; the nightly feed will supply them. One of: listed, complete, documents_failed. |
previous_accession | string | null | no | |
released_at | date-time (RFC 3339, UTC) | null | no | |
snapshot | Snapshot | no | |
versions | Versions | no |
Example request
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001829126-26-010431'Open this route in the console
More in Filings
Previous: GET /v3/filings · Next: GET /v3/filings/{accession}/documents
Markdown version: /docs/reference/get-filings-accession.md