Skip to content

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.

FieldTypeAlways presentDescription
accepted_atdate-time (RFC 3339, UTC) | nullnoWhen 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_sourcestring | nullnoWhere 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
accessionstringno—
base_formstringno—
deletedbooleannoTrue when status is deleted.
deleted_atdate-time (RFC 3339, UTC) | nullnoWhen 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.
deletionobject | nullnoOnly 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_datedate (YYYY-MM-DD) | nullnoThe feed day that delivered the notice.
deletion.noticestring | nullnoThe notice's place in the feed, as <archive>#<member>.
deletion.recorded_atdate-time (RFC 3339, UTC) | nullnoWhen SEC Blast recorded the deletion.
deletion.sourcestring | nullnoWhere the deletion notice came from. Today always feed: SEC's nightly feed, which carries the notices.
filing_datedate (YYYY-MM-DD)no—
form_typestringnoForm type as filed, such as 10-K or 10-K/A.
linksobjectnoIts fields follow, as links.….
links.selfstringno—
period_of_reportdate (YYYY-MM-DD) | nullnoThe period the filing reports on. SEC's report date when SEC gives one, else the date in the filing's header.
period_of_report_sourcestring | nullnoOne of: submissions, header.
primary_cikstringno—
primary_namestring | nullnoName of the primary filer as filed. Without a header (header_in_file false), the name in SEC's index, or null.
provisionalbooleannoTrue when status is provisional.
statusstringnoprovisional: 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

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

Markdown version: /docs/reference/schemas/filing-ref.md