Skip to content

FilingDetail

Fields

Nested fields are written with dots; [] marks the items of an array.

FieldTypeAlways presentDescription
accepted_atdate-time (RFC 3339, UTC) | nullnoWhen the SEC accepted the filing. A time from the filing's own header wins, and once stored it never changes; a later SEC value goes to accepted_at_snapshot. More
accepted_at_snapshotdate-time (RFC 3339, UTC)noSEC's acceptance time as given. Present only when it differs from accepted_at by a second or more.
accepted_at_sourcestring | nullnoWhere accepted_at comes from. realtime and archives_txt: the filing's header, from live ingest or SEC's archives. One of: realtime, archives_txt, submissions_corrected, submissions_unverified, oldload, submissions. More
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, such as 10-K or 10-K/A.
header_in_filebooleannoSingle filing only. false when SEC's submission file has no SGML header, as in some 1994-1995 files. More
is_amendmentbooleanyes—
is_inline_xbrlboolean | nullnoWhether SEC says the filing uses inline XBRL. Null as for is_xbrl.
is_xbrlboolean | nullnoWhether SEC says the filing has XBRL data. Null when SEC does not say or its data has not covered the filing yet.
itemsarray of stringno—
items_unmappedarray of stringno—
linksobjectyesIts fields follow, as links.….
links.documentsstringno—
links.eventsstringno—
links.headerstring | nullnoNull when header_in_file is false (single filing).
links.selfstringno—
period_of_reportdate (YYYY-MM-DD) | nullnoThe period the filing reports on. SEC's report date when SEC gives one, else the date in the filing's header.
period_of_report_headerdate (YYYY-MM-DD) | nullnoSingle filing only. The header's period, shown when SEC's report date replaced a different one. Null when the header has none.
period_of_report_sourcestring | nullnoOne of: submissions, header.
primary_cikstringyes—
primary_namestring | nullnoName of the primary filer as filed. Without a header (header_in_file false), the name in SEC's index, or null.
provisionalbooleannoTrue when status is provisional.
sec_itemsarray of string | nullnoSEC's list of 8-K items. items holds the header's list. Null when SEC's data has not covered the filing yet.
sec_primary_doc_descriptionstring | nullnoSingle filing only. SEC's description of the primary document.
sec_primary_documentstring | nullnoFile name of the primary document, according to SEC.
sec_urlstring (URI)yes—
snapshot_datedate (YYYY-MM-DD) | nullnoSingle filing only. Date of the SEC snapshot whose values were last written to the filing. Null when none was.
sourcestringnoHow the filing arrived. realtime: from live ingest; it becomes feed when the nightly feed delivers the filing. One of: feed, oldload, archives, realtime.
statusstringyesprovisional: added by live ingest and not yet confirmed by SEC's nightly feed. The feed makes it final and may replace its documents. One of: provisional, final, deleted. More
total_bytesintegerno—
date_of_changedate (YYYY-MM-DD) | nullno—
deletedbooleannoTrue when status is deleted.
deletionobject | nullnoWhere the deletion came from, for a deleted filing; null otherwise. SEC's deletion notice gives no reason.
deletion.feed_datedate (YYYY-MM-DD) | nullnoThe feed day that delivered the notice.
deletion.noticestring | nullnoThe notice's place in the feed, as <archive>#<member>.
deletion.recorded_atdate-time (RFC 3339, UTC) | nullnoWhen SEC Blast recorded the deletion.
deletion.sourcestring | nullnoWhere the deletion notice came from. Today always feed: SEC's nightly feed, which carries the notices.
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—
liveobjectnoProgress of live ingest on this filing. Present only while the filing is provisional and came from live ingest.
live.documents_atdate-time (RFC 3339, UTC) | nullnoWhen its documents were added. Null until then.
live.listed_atdate-time (RFC 3339, UTC) | nullnoWhen the filing was listed.
live.statestringnolisted: the header is in (companies, items, acceptance time, /header), and the documents are still being fetched (doc_count is 0). complete: the documents are in. One of: listed, complete, documents_failed. More
previous_accessionstring | nullno—
released_atdate-time (RFC 3339, UTC) | nullno—
snapshotSnapshotnoWhich copy of SEC's daily submissions data the response uses. On filing responses, it is the copy whose values SEC Blast last stored; available is false until the first copy is stored.
versionsVersionsnoA report's original filing and its amendments. One member when nothing is linked.

Field notes

accepted_at

Otherwise the time comes from SEC's submissions data: corrected for the New York time offset SEC adds, for new filings (submissions_corrected), or as SEC gives it, for older filings, which can be off by one or two such offsets (submissions_unverified). Null when no source has a time.

accepted_at_source

submissions_corrected and submissions_unverified: SEC's submissions data (see accepted_at). oldload and submissions are no longer written.

header_in_file

The form type, filing date, and filers then come from SEC's index, links.header is null, and /header answers 404 no_header_in_file.

status

deleted: SEC deleted (withdrew) the filing. It is still served, with its documents when they were delivered.

live.state

documents_failed: they could not be fetched; the nightly feed will supply them.

Used by

Markdown version: /docs/reference/schemas/filing-detail.md