Skip to content

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

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).

Responses

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

FieldTypeRequiredDescription
accepted_atdate-time (RFC 3339, UTC) | nullnoThe 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_snapshotdate-time (RFC 3339, UTC)noPresent only when SEC's submissions value differs from accepted_at (at whole seconds): SEC's value as given.
accepted_at_sourcestring | nullnorealtime / 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.
accessionstringyes
base_formstringyes
deleted_atdate-time (RFC 3339, UTC) | nullno
doc_countintegerno
feed_datedate (YYYY-MM-DD) | nullno
filing_datedate (YYYY-MM-DD)yes
first_seen_atdate-time (RFC 3339, UTC) | nullno
form_typestringyesForm type as filed.
header_in_filebooleannoSingle 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_amendmentbooleanyes
is_inline_xbrlboolean | nullnoSEC's isInlineXBRL; null as is_xbrl.
is_xbrlboolean | nullnoSEC's isXBRL; null when SEC does not say or the snapshot sync has not seen the filing.
itemsarray of stringno
items_unmappedarray of stringno
linksobjectyes
links.documentsstringno
links.eventsstringno
links.headerstring | nullnonull when header_in_file is false (single filing).
links.selfstringno
period_of_reportdate (YYYY-MM-DD) | nullnoSEC's reportDate (submissions snapshot) when it gives one, otherwise the value in the filing's header.
period_of_report_headerdate (YYYY-MM-DD) | nullnoSingle filing only, and only when SEC's reportDate replaced a different header period: the header's (null: the header has none).
period_of_report_sourcestring | nullnoOne of: submissions, header, null.
primary_cikstringyes
primary_namestring | nullnoName of the primary entity as filed (header_in_file false: the name SEC's submissions index gives for the filing date, or null).
provisionalbooleannostatus == provisional.
sec_itemsarray of string | nullnoSEC's 8-K items list (items is the header's); null when the snapshot sync has not seen the filing.
sec_primary_doc_descriptionstring | nullnoSingle filing only: SEC's primaryDocDescription.
sec_primary_documentstring | nullnoSEC's primaryDocument (file name).
sec_urlstring (URI)yes
snapshot_datedate (YYYY-MM-DD) | nullnoSingle filing only: the snapshot whose values were last written to the filing; null when none was.
sourcestringnorealtime: registered by live ingest; it becomes feed when the nightly feed delivers the filing. One of: feed, oldload, archives, realtime.
statusstringyesprovisional: 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_bytesintegerno
date_of_changedate (YYYY-MM-DD) | nullno
deletedbooleannostatus == deleted.
deletionobject | nullnoOnly for a deleted filing (null otherwise): where the deletion came from. SEC's DELETION notice gives no reason.
deletion.feed_datedate (YYYY-MM-DD) | nullnoThe feed day whose archive held the notice.
deletion.noticestring | nullnoThe notice member, <archive>#<member>.
deletion.recorded_atdate-time (RFC 3339, UTC) | nullnoWhen v3 registered the deletion.
deletion.sourcestring | nullnoWhere 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.
documentsarray of Documentno
effectiveness_datedate (YYYY-MM-DD) | nullno
entitiesarray of FilingEntityno
eventsarray of Eventno
finalized_atdate-time (RFC 3339, UTC) | nullno
is_correctionbooleanno
is_paperbooleanno
is_private_releasebooleanno
liveobjectnoOnly while the filing is provisional and its source is realtime: where live ingest is with it. Gone once the filing is final.
live.documents_atdate-time (RFC 3339, UTC) | nullnoWhen its documents were registered; null until then.
live.listed_atdate-time (RFC 3339, UTC) | nullnoWhen the filing was listed.
live.statestringnolisted: 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_accessionstring | nullno
released_atdate-time (RFC 3339, UTC) | nullno
snapshotSnapshotno
versionsVersionsno

Example request

Shell
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