Skip to content

GET /v3/coverage/count

The live filing count, in one small answer that needs no key, for polling: filings (final and provisional; deleted filings are not counted), provisional, deleted, documents, the newest acceptance time and, when this deployment has live ingest, the live daemon's latency over its day. The answer comes from memory, never from a database query of its own: the server adds what was registered since the counts of /v3/coverage/summary (computed every 15 minutes) to them every few seconds (5 by default); as_of says when. filings never goes down between two answers of a running server except after a deletion; filings registered with an old acceptance time (backfills) are added at the next summary computation. Right after one, filings equals final + provisional of /v3/coverage/summary. ETag (weak, over everything but as_of): If-None-Match answers 304 while nothing changed. Until the first computation after a start has finished the answer is 503 with code warming_up and Retry-After. Cache-Control: public, max-age=5.

API key: not needed.

Group: Coverage, usage and service

Parameters

This route takes no parameters.

Responses

StatusBodyDescription
200CoverageCount (application/json)OK
503Problem (application/problem+json)Database unavailable (code db_unavailable); or the answer, which the server computes in the background, has not been computed yet since it started (code warming_up). Retry the same request after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a CoverageCount object.

FieldTypeRequiredDescription
as_ofdate-time (RFC 3339, UTC)yesWhen these figures were read, UTC (every few seconds; 5 by default).
deletedintegeryesFilings SEC deleted (status deleted), now. Not counted in filings; they are still served.
documentsintegeryesCurrent documents, counted as documents of /v3/coverage/summary (one per document of each filing, deleted filings included) plus those of filings registered since. Never goes down within a running server.
filingsintegeryesFilings in v3 that are not deleted: final and provisional (filings_basis). Never goes down between two answers of a running server except after a deletion. A filing registered with an old acceptance time (a backfill) is added at the next computation of /v3/coverage/summary, at most about 20 minutes later; right after that computation filings equals its filings.final + filings.provisional.
filings_basisstringyesWhat filings counts: final and provisional filings; deleted filings are not counted. One of: final_and_provisional.
latest_accepted_atdate-time (RFC 3339, UTC) | nullyesThe newest SEC acceptance time of a filing that is not deleted.
liveobject | nullyesLive ingest latency over the daemon's current New York day, from its own status, read with the counts. "seen" is when SEC Blast's poll of SEC's list of new filings first saw the filing. SEC publishes no time at which a filing appears in that list, so the time from SEC publishing a filing to it being seen is not measured; it is bounded by poll_interval_ms. Null when this deployment has no live ingest.
live.accept_to_seen_msobjectnoSEC's acceptance time to seen, milliseconds.
live.accept_to_seen_ms.p50number | nullno
live.accept_to_seen_ms.p95number | nullno
live.checkstringnoAs checks.live of /v3/health. One of: ok, paused, degraded, down.
live.ninteger | nullnoFilings whose documents live ingest stored that day.
live.poll_interval_msnumber | nullnoThe daemon's current interval between two polls of SEC's list.
live.seen_to_documents_msobjectnoSeen to the filing's documents being stored and registered, milliseconds.
live.seen_to_documents_ms.p50number | nullno
live.seen_to_documents_ms.p95number | nullno
live.seen_to_stored_msobjectnoSeen to the filing being registered in the database (from then on the API lists it, provisional), milliseconds.
live.seen_to_stored_ms.p50number | nullno
live.seen_to_stored_ms.p95number | nullno
live.windowstringnoThe figures cover the daemon's current New York day. One of: day.
live.window_openboolean | nullnoThe daemon is in its business-hours window (fast polling).
provisionalintegeryesFilings registered by live ingest and not yet confirmed by SEC's nightly feed (status provisional), now.
summary_computed_atdate-time (RFC 3339, UTC) | nullyescomputed_at of the /v3/coverage/summary counts these figures add to.

Example request

Shell
curl -sS 'https://api.secblast.com/v3/coverage/count'

Open this route in the console

More in Coverage, usage and service

Previous: GET /v3/coverage · Next: GET /v3/coverage/summary

Markdown version: /docs/reference/get-coverage-count.md