# 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) |
| `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](#accepted-at-source) |
| `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](#header-in-file) |
| `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](#status) |
| `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](https://www.secblast.com/docs/reference/schemas/document) | no | — |
| `effectiveness_date` | date (YYYY-MM-DD) \| null | no | — |
| `entities` | array of [FilingEntity](https://www.secblast.com/docs/reference/schemas/filing-entity) | no | — |
| `events` | array of [Event](https://www.secblast.com/docs/reference/schemas/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](#live-state) |
| `previous_accession` | string \| null | no | — |
| `released_at` | date-time (RFC 3339, UTC) \| null | no | — |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas/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](https://www.secblast.com/docs/reference/schemas/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}`](https://www.secblast.com/docs/reference/get-filings-accession).
