# FilingRef

The filing this parsed result comes from. Its fields are a subset of Filing, with the same names, types, and values.

## 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_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 | no | — |
| `base_form` | string | no | — |
| `deleted` | boolean | no | True when status is deleted. |
| `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. |
| `deletion` | object \| null | no | Only on routes for one filing; lists leave it out. 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. |
| `filing_date` | date (YYYY-MM-DD) | no | — |
| `form_type` | string | no | Form type as filed, such as 10-K or 10-K/A. |
| `links` | object | no | Its fields follow, as `links.…`. |
| `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_source` | string \| null | no | One of: `submissions`, `header`. |
| `primary_cik` | string | no | — |
| `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. |
| `status` | string | no | 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) |

## 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.

### `status`

deleted: SEC deleted (withdrew) the filing. It is still served, with its documents when they were delivered.

## Used by

- Part of [DocTables](https://www.secblast.com/docs/reference/schemas/doc-tables), [EightKEventList](https://www.secblast.com/docs/reference/schemas/eight-k-event-list), [EightKFiling](https://www.secblast.com/docs/reference/schemas/eight-k-filing), [EightKItemSearchList](https://www.secblast.com/docs/reference/schemas/eight-k-item-search-list), [F13fFiling](https://www.secblast.com/docs/reference/schemas/f13f-filing), [F13fHoldingList](https://www.secblast.com/docs/reference/schemas/f13f-holding-list), [F144Filing](https://www.secblast.com/docs/reference/schemas/f144-filing), [OwnershipFiling](https://www.secblast.com/docs/reference/schemas/ownership-filing), [ParsedChanges](https://www.secblast.com/docs/reference/schemas/parsed-changes), [ParsedList](https://www.secblast.com/docs/reference/schemas/parsed-list), [SectionMapOfFiling](https://www.secblast.com/docs/reference/schemas/section-map-of-filing), [SectionSearchList](https://www.secblast.com/docs/reference/schemas/section-search-list), [SectionsOfFiling](https://www.secblast.com/docs/reference/schemas/sections-of-filing), [XbrlFilingFacts](https://www.secblast.com/docs/reference/schemas/xbrl-filing-facts), [XbrlFilingRoles](https://www.secblast.com/docs/reference/schemas/xbrl-filing-roles), and [XbrlFilingStatements](https://www.secblast.com/docs/reference/schemas/xbrl-filing-statements).
