# 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) |
| `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 | 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](#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 | 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](#status) |
| `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](https://www.secblast.com/docs/reference/schemas/filing-list).
