Skip to content

Coverage

Fields

Nested fields are written with dots; [] marks the items of an array.

FieldTypeAlways presentDescription
computed_atdate-time (RFC 3339, UTC)noWhen data was computed, in UTC.
dataarray of CoverageDayyesOne row per feed day, newest first, with the day's latest ingest run. At most window.max_days rows: the newest days of the window.
liveobject | nullnoThe last status report of live ingest, written every 10 seconds. Null when there is none. It can be old: live_check gives the judgement. Values out of range are null.
live.covered_untildate-time (RFC 3339, UTC) | nullnoSEC's list of new filings has been read without a gap up to this time.
live.endedstring | nullnoHow the run ended. Null while it runs. One of: clean, failed.
live.fetchobjectnoRequests to SEC: requests, http_404, http_429, http_5xx, network, integrity, too_large, bytes, and recent {requests, failed}.
live.filingsobjectnoCounts since the run started: seen, listed, documents, failed, skipped_known, per_min_1, per_min_5, and per_min_peak.
live.heartbeat_atdate-time (RFC 3339, UTC) | nullno—
live.items_unmappednumber | nullno8-K item descriptions seen without an item code.
live.last_new_accessionstring | nullno—
live.last_new_filing_atdate-time (RFC 3339, UTC) | nullno—
live.latency_msobjectnorecent (the last window_s seconds) and day: n, and p50 and p95 of accept_to_seen, seen_to_listed, and seen_to_documents.
live.limiterobjectnoThe shared limit on requests to SEC: priority (on, off, or unavailable), wait_ms {p50, p95}, waits_over_1s, and refused.
live.modestring | nullnoOne of: live, dry_run.
live.paused_untildate-time (RFC 3339, UTC) | nullno—
live.pauses_24hnumber | nullno—
live.pollobjectnoCounts of checks of SEC's list. rtt_ms and skew_ms are in milliseconds.
live.poll.below_page0number | nullno—
live.poll.failednumber | nullno—
live.poll.last_ok_atdate-time (RFC 3339, UTC) | nullno—
live.poll.last_poll_failedbooleannoWhether the last check failed.
live.poll.oknumber | nullno—
live.poll.out_of_ordernumber | nullno—
live.poll.overflowsnumber | nullno—
live.poll.pages_sweptnumber | nullno—
live.poll.rtt_msobjectno—
live.poll.skew_msnumber | nullno—
live.poll.sweepsobjectno—
live.poll.sweeps_abandonednumber | nullno—
live.poll.sweeps_exhaustednumber | nullno—
live.poll.uncoveredarray of objectnoUp to 50 time spans of SEC's list that could not be read. The nightly feed covers those filings.
live.poll.uncovered[].atdate-time (RFC 3339, UTC) | nullno—
live.poll.uncovered[].fromdate-time (RFC 3339, UTC) | nullno—
live.poll.uncovered[].reasonstring | nullnoOne of: max_start, page_unanswered.
live.poll.uncovered[].untildate-time (RFC 3339, UTC) | nullno—
live.poll_interval_msnumber | nullno—
live.queueobjectnoWork waiting: fetch_fresh, fetch_backlog, build, retry, oldest_age_s, and behind_since.
live.roles_unmappedintegernoRole names in SEC's list that match no known role.
live.schemanumber | nullno—
live.started_atdate-time (RFC 3339, UTC) | nullno—
live.statestring | nullnoOne of: ok, idle, catching_up, paused, cautious, sec_unreachable, db_down, disk_low, halted, stopping, stopped, failed.
live.window_openboolean | nullno—
live_checkstringnoSame as checks.live of /v3/health. One of: ok, paused, degraded, down, disabled.
snapshotobjectyesThe SEC snapshot in use.
snapshot.accessionsinteger | nullnoDistinct filings in the snapshot.
snapshot.age_daysinteger | nullno—
snapshot.availablebooleanno—
snapshot.datedate (YYYY-MM-DD) | nullno—
snapshot.fallbackboolean | nullnoTrue when a newer snapshot exists but could not be loaded.
snapshot.filersinteger | nullno—
snapshot.filingsinteger | nullnoFiling rows in the snapshot. A filing listed by two filers counts twice.
snapshot.loaded_atdate-time (RFC 3339, UTC) | nullno—
snapshot.reloadingboolean | nullnoTrue while a newer snapshot loads. The current one keeps serving.
snapshot.staleboolean | nullnoTrue when the snapshot is more than 3 days old.
snapshot.statestringnoOne of: ok, stale, loading, unavailable, disabled.
snapshot.tickers_datedate (YYYY-MM-DD) | nullnoDate of the newest copy of SEC's ticker file.
snapshot.tickers_fromdate (YYYY-MM-DD) | nullnoDate of the oldest copy kept.
totalsobjectyesTotals over all filings, whatever the window. Computed in the background every few minutes. If a computation fails, the previous totals stay; computed_at shows their age.
totals.accepted_at_storedintegernoFilings with a stored acceptance time, from the filing's header or from SEC's records.
totals.amendmentsintegernoAmendments, not counting deleted ones.
totals.amendments_resolvedintegernoAmendments linked to their original.
totals.computed_atdate-time (RFC 3339, UTC)noWhen the totals were computed, in UTC.
totals.deleted_filingsintegerno—
totals.documentsintegerno—
totals.filingsintegerno—
totals.max_feed_datedate (YYYY-MM-DD) | nullno—
totals.max_filing_datedate (YYYY-MM-DD) | nullno—
totals.min_feed_datedate (YYYY-MM-DD) | nullno—
totals.min_filing_datedate (YYYY-MM-DD) | nullno—
truncatedbooleanyesTrue when the window holds more than max_days feed days. The older days are left out; ask for them with from and to.
windowobjectyesThe feed days this answer covers.
window.defaultbooleannoTrue when neither from nor to was given: the last 90 feed days.
window.fromdate (YYYY-MM-DD) | nullnoThe from you asked for. Without one, the oldest day listed; null when no day is listed.
window.max_daysintegernoThe most days one answer lists: 90 by default, 366 when from or to is given.
window.todate (YYYY-MM-DD) | nullnoThe to you asked for. Without one, the newest day listed; null when no day is listed.

Used by

Markdown version: /docs/reference/schemas/coverage.md