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
| Status | Body | Description |
|---|---|---|
200 | CoverageCount (application/json) | OK |
503 | Problem (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. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a CoverageCount object.
| Field | Type | Required | Description |
|---|---|---|---|
as_of | date-time (RFC 3339, UTC) | yes | When these figures were read, UTC (every few seconds; 5 by default). |
deleted | integer | yes | Filings SEC deleted (status deleted), now. Not counted in filings; they are still served. |
documents | integer | yes | Current 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. |
filings | integer | yes | Filings 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_basis | string | yes | What filings counts: final and provisional filings; deleted filings are not counted. One of: final_and_provisional. |
latest_accepted_at | date-time (RFC 3339, UTC) | null | yes | The newest SEC acceptance time of a filing that is not deleted. |
live | object | null | yes | Live 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_ms | object | no | SEC's acceptance time to seen, milliseconds. |
live.accept_to_seen_ms.p50 | number | null | no | |
live.accept_to_seen_ms.p95 | number | null | no | |
live.check | string | no | As checks.live of /v3/health. One of: ok, paused, degraded, down. |
live.n | integer | null | no | Filings whose documents live ingest stored that day. |
live.poll_interval_ms | number | null | no | The daemon's current interval between two polls of SEC's list. |
live.seen_to_documents_ms | object | no | Seen to the filing's documents being stored and registered, milliseconds. |
live.seen_to_documents_ms.p50 | number | null | no | |
live.seen_to_documents_ms.p95 | number | null | no | |
live.seen_to_stored_ms | object | no | Seen to the filing being registered in the database (from then on the API lists it, provisional), milliseconds. |
live.seen_to_stored_ms.p50 | number | null | no | |
live.seen_to_stored_ms.p95 | number | null | no | |
live.window | string | no | The figures cover the daemon's current New York day. One of: day. |
live.window_open | boolean | null | no | The daemon is in its business-hours window (fast polling). |
provisional | integer | yes | Filings registered by live ingest and not yet confirmed by SEC's nightly feed (status provisional), now. |
summary_computed_at | date-time (RFC 3339, UTC) | null | yes | computed_at of the /v3/coverage/summary counts these figures add to. |
Example request
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