Filing
Fields
Nested fields are written with dots; [] marks the items of an array.
| Field | Type | Always present | Description |
|---|---|---|---|
accepted_at | date-time (RFC 3339, UTC) | null | no | When 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_snapshot | date-time (RFC 3339, UTC) | no | SEC's acceptance time as given. Present only when it differs from accepted_at by a second or more. |
accepted_at_source | string | null | no | Where 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 |
accession | string | yes | — |
base_form | string | yes | — |
deleted_at | date-time (RFC 3339, UTC) | null | no | When 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_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 | When 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_type | string | yes | Form type as filed, such as 10-K or 10-K/A. |
header_in_file | boolean | no | Single filing only. false when SEC's submission file has no SGML header, as in some 1994-1995 files. More |
is_amendment | boolean | yes | — |
is_inline_xbrl | boolean | null | no | Whether SEC says the filing uses inline XBRL. Null as for is_xbrl. |
is_xbrl | boolean | null | no | Whether SEC says the filing has XBRL data. Null when SEC does not say or its data has not covered the filing yet. |
items | array of string | no | — |
items_unmapped | array of string | no | Item descriptions in the header that have no item code yet. In lists only when there are any; always on the single filing. |
links | object | yes | Its fields follow, as links.…. |
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 | The period the filing reports on. SEC's report date when SEC gives one, else the date in the filing's header. |
period_of_report_header | date (YYYY-MM-DD) | null | no | Single 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_source | string | null | no | One of: submissions, header. |
primary_cik | string | yes | — |
primary_name | string | null | no | Name of the primary filer as filed. Without a header (header_in_file false), the name in SEC's index, or null. |
provisional | boolean | no | True when status is provisional. |
sec_items | array of string | null | no | SEC'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_description | string | null | no | Single filing only. SEC's description of the primary document. |
sec_primary_document | string | null | no | File name of the primary document, according to SEC. |
sec_url | string (URI) | yes | — |
snapshot_date | date (YYYY-MM-DD) | null | no | Single filing only. Date of the SEC snapshot whose values were last written to the filing. Null when none was. |
source | string | no | How the filing arrived. realtime: from live ingest; it becomes feed when the nightly feed delivers the filing. One of: feed, oldload, archives, realtime. |
status | string | yes | provisional: 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_bytes | integer | no | — |
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
- Part of FilingList.
Markdown version: /docs/reference/schemas/filing.md