FilingDetail
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 | — |
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, 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 | — |
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 | — |
date_of_change | date (YYYY-MM-DD) | null | no | — |
deleted | boolean | no | True when status is deleted. |
deletion | object | null | no | Where the deletion came from, for a deleted filing; null otherwise. SEC's deletion notice gives no reason. |
deletion.feed_date | date (YYYY-MM-DD) | null | no | The feed day that delivered the notice. |
deletion.notice | string | null | no | The notice's place in the feed, as <archive>#<member>. |
deletion.recorded_at | date-time (RFC 3339, UTC) | null | no | When SEC Blast recorded the deletion. |
deletion.source | string | null | no | Where the deletion notice came from. Today always feed: SEC's nightly feed, which carries the notices. |
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 | Progress of live ingest on this filing. Present only while the filing is provisional and came from live ingest. |
live.documents_at | date-time (RFC 3339, UTC) | null | no | When its documents were added. 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 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_accession | string | null | no | — |
released_at | date-time (RFC 3339, UTC) | null | no | — |
snapshot | Snapshot | no | Which 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. |
versions | Versions | no | A 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
- Returned by
GET /v3/filings/{accession}.
Markdown version: /docs/reference/schemas/filing-detail.md