Skip to content

CoverageSummary

Fields

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

FieldTypeAlways presentDescription
amendmentsobjectyesAmendment links by status, not counting deleted filings. link_rate is resolved divided by total, to 4 decimals; null when total is 0.
amendments.ambiguousintegerno—
amendments.link_ratenumber | nullno—
amendments.resolvedintegerno—
amendments.target_not_publicintegerno—
amendments.target_not_yet_ingestedintegerno—
amendments.totalintegerno—
amendments.unresolvedintegerno—
before_1993objectyesFilings dated before 1993, not counting deleted ones. They are paper records entered later, or dates SEC mistyped. They are not years of coverage.
before_1993.filingsintegerno—
before_1993.first_yearinteger | nullnoThe earliest year counted. Null when filings is 0.
before_1993.paperintegernoOf these, records of paper filings.
by_yeararray of objectyesFilings per calendar year from 1993 (EDGAR's first year), oldest first. Deleted filings are not counted. Earlier dates are counted in before_1993.
by_year[].filingsintegerno—
by_year[].paperintegernoOf these, records of paper filings.
by_year[].yearintegerno—
by_year_basisstringyesThe date that by_year groups by. One of: filing_date.
callbacksobject | nullyesWebhook delivery, computed with the counts. Null when webhooks are not set up.
callbacks.computed_atdate-time (RFC 3339, UTC)noWhen the callbacks block was computed, in UTC.
callbacks.latencyobjectnoIts fields follow, as callbacks.latency.….
callbacks.latency.first_attempt_from_acceptedobjectnoSeconds from SEC's acceptance to the first delivery attempt, for filing.new deliveries of live filings in the last 24 hours. Test sends are left out. n is the number of first attempts.
callbacks.latency.first_attempt_from_accepted.nintegerno—
callbacks.latency.first_attempt_from_accepted.p50number | nullnoNull when n is 0.
callbacks.latency.first_attempt_from_accepted.p95number | nullnoNull when n is 0.
computed_atdate-time (RFC 3339, UTC)yesWhen the counts were computed, in UTC.
document_versionsintegeryesStored document versions: every delivery of every document.
documentsintegeryesDocuments, one per document of each filing.
feed_daysobjectyesFeed days with a complete or partial ingest run.
feed_days.countintegerno—
feed_days.firstdate (YYYY-MM-DD) | nullno—
feed_days.lastdate (YYYY-MM-DD) | nullno—
filingsobjectyesFilings by status. total counts every status.
filings.deletedintegerno—
filings.finalintegerno—
filings.provisionalintegerno—
filings.totalintegerno—
gapsobject | nullyesKnown coverage gaps: feed days missing from SEC's archive, feed days SEC delivered cut short, and filings no feed delivers. Null when no list is set up.
liveobject | nullyesLive ingest, read on each request. Null when live ingest is not set up.
live.checkstringnoSame as checks.live of /v3/health. One of: ok, paused, degraded, down.
live.covered_untildate-time (RFC 3339, UTC) | nullnoSEC's list of new filings has been read without a gap up to this time.
live.last_new_filing_atdate-time (RFC 3339, UTC) | nullnoWhen the newest filing was first seen.
live.median_lag_secondsinteger | nullnoMedian seconds from SEC's acceptance to the filing being seen, today in New York time. Null with fewer than 5 filings today.
live.modestring | nullnoOne of: live, dry_run.
live.statestring | nullnoWhat live ingest last reported, as live.state of /v3/health (a test run shows its own state, not dry_run).
streamobject | nullyesThe filing stream, computed with the counts. Null when the stream is not set up.
stream.computed_atdate-time (RFC 3339, UTC)noWhen the stream block was computed, in UTC.
stream.head_seqinteger | nullnoThe newest stream position. Null before the first event.
stream.latencyobjectnoIts fields follow, as stream.latency.….
stream.latency.from_acceptedobjectnoSeconds from SEC's acceptance to the filing.new event, for live filings of the last 24 hours. n is the number of filings.
stream.latency.from_accepted.nintegerno—
stream.latency.from_accepted.p50number | nullnoNull when n is 0.
stream.latency.from_accepted.p95number | nullnoNull when n is 0.

Used by

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