Skip to content

Filing

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) | nullnoWhen SEC deleted the filing: the time on its deletion notice, or midnight New York time on the notice's feed day when it has none. Null unless status is deleted.
doc_countintegerno—
feed_datedate (YYYY-MM-DD) | nullno—
filing_datedate (YYYY-MM-DD)yes—
first_seen_atdate-time (RFC 3339, UTC) | nullnoWhen SEC Blast first saw the filing. For a live filing, when it appeared in SEC's list of new filings. For older filings, when SEC Blast loaded it, which can be years after it was filed.
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 stringnoItem descriptions in the header that have no item code yet. In lists only when there are any; always on the single filing.
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—

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.

Used by

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