# GET /v3/coverage/summary

What v3 holds, in one answer that needs no key: filings by status, documents, document versions, the feed days ingested (first, last, count), filings per filing-date year, amendment links by status, the known coverage gaps (a list maintained by hand) and, when this deployment has live ingest, the live daemon's state and lag. The counts are computed in the background, never by a request: once at start and then every 15 minutes by default (at the next background pass after that); computed_at says when, and they are served until the next computation replaces them. live is read per request. 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=300.

**API key:** not needed.

**Group:** [Coverage, usage and service](https://www.secblast.com/docs/reference#coverage-usage-and-service)

## Parameters

This route takes no parameters.

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [CoverageSummary](https://www.secblast.com/docs/reference/schemas#schema-coveragesummary) (`application/json`) | OK |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [CoverageSummary](https://www.secblast.com/docs/reference/schemas#schema-coveragesummary) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `amendments` | object | yes | Amendment links by link status; amendments of deleted filings are not counted. link_rate is resolved / total, rounded to 4 decimals; null when total is 0. |
| `amendments.ambiguous` | integer | no |   |
| `amendments.link_rate` | number \| null | no |   |
| `amendments.resolved` | integer | no |   |
| `amendments.target_not_public` | integer | no |   |
| `amendments.target_not_yet_ingested` | integer | no |   |
| `amendments.total` | integer | no |   |
| `amendments.unresolved` | integer | no |   |
| `before_1993` | object | yes | Filings whose by_year_basis date is before 1993, deleted filings not counted: paper records keyed in later, and dates SEC mistyped. Not years of coverage, so not in by_year. |
| `before_1993.filings` | integer | no |   |
| `before_1993.first_year` | integer \| null | no | The earliest year counted; null when filings is 0. |
| `before_1993.paper` | integer | no | Paper filing records among filings (is_paper). |
| `by_year` | array of object | yes | Filings per calendar year of by_year_basis from 1993 (EDGAR's first year), oldest year first; deleted filings are not counted. Filings dated earlier are counted in before_1993. |
| `by_year[].filings` | integer | no |   |
| `by_year[].paper` | integer | no | Paper filing records among filings (is_paper). |
| `by_year[].year` | integer | no |   |
| `by_year_basis` | string | yes | The date by_year groups by. One of: `filing_date`. |
| `callbacks` | object \| null | yes | Webhook delivery, computed with the counts. Null when this deployment has no webhook delivery. |
| `callbacks.computed_at` | date-time (RFC 3339, UTC) | no | When the callbacks block was computed, UTC. |
| `callbacks.latency` | object | no |   |
| `callbacks.latency.first_attempt_from_accepted` | object | no | Seconds from SEC's acceptance to the first delivery attempt, over the first attempts of the last 24 hours of filing.new and search.match deliveries of live filings (test sends and filings first seen in the nightly feed are left out; nearest-rank percentiles; n is the number of first attempts). |
| `callbacks.latency.first_attempt_from_accepted.n` | integer | no |   |
| `callbacks.latency.first_attempt_from_accepted.p50` | number \| null | no | Null when n is 0. |
| `callbacks.latency.first_attempt_from_accepted.p95` | number \| null | no | Null when n is 0. |
| `computed_at` | date-time (RFC 3339, UTC) | yes | When the counts were computed, UTC. They are served until a later computation replaces them. |
| `document_versions` | integer | yes | Stored document versions, every delivery of every document. |
| `documents` | integer | yes | Current documents (one per document of each filing). |
| `feed_days` | object | yes | Feed days with a complete or partial ingest run (targeted repair runs not counted). |
| `feed_days.count` | integer | no |   |
| `feed_days.first` | date (YYYY-MM-DD) \| null | no |   |
| `feed_days.last` | date (YYYY-MM-DD) \| null | no |   |
| `filings` | object | yes | Filings in v3 by status; total counts every status. |
| `filings.deleted` | integer | no |   |
| `filings.final` | integer | no |   |
| `filings.provisional` | integer | no |   |
| `filings.total` | integer | no |   |
| `gaps` | object \| null | yes | Known coverage gaps, from a list maintained by hand and read when the server starts: feed days absent from the archive, feed days SEC delivered truncated, and filings no feed delivers. Null when this deployment has no list. |
| `live` | object \| null | yes | Live ingest, read per request from the daemon's newest session (at most once every 2 s for the whole process). Null when this deployment has no live ingest. |
| `live.check` | string | no | As checks.live of /v3/health. One of: `ok`, `paused`, `degraded`, `down`. |
| `live.covered_until` | date-time (RFC 3339, UTC) \| null | no | SEC's list of new filings has been read without a gap up to here. |
| `live.last_new_filing_at` | date-time (RFC 3339, UTC) \| null | no | When the newest filing was first seen. |
| `live.median_lag_seconds` | integer \| null | no | Median seconds from SEC's acceptance to the filing being seen, over the daemon's current New York day; null with fewer than 5 filings that day, and when the figure is negative or absurd. |
| `live.mode` | string \| null | no | One of: `live`, `dry_run`, `null`. |
| `live.state` | string \| null | no | The daemon's own state in its last heartbeat, as live.state of /v3/health without the dry_run substitution. |
| `stream` | object \| null | yes | The filing stream, computed with the counts. Null when this deployment has no stream. |
| `stream.computed_at` | date-time (RFC 3339, UTC) | no | When the stream block was computed, UTC. |
| `stream.head_seq` | integer \| null | no | The last stream seq the sequencer assigned; null before its first pass. |
| `stream.latency` | object | no |   |
| `stream.latency.from_accepted` | object | no | Seconds from SEC's acceptance to the filing.new event, over live filings of the last 24 hours (nearest-rank percentiles; n is the number of filings, zeros when it is 0). |
| `stream.latency.from_accepted.n` | integer | no |   |
| `stream.latency.from_accepted.p50` | number \| null | no | Null when n is 0. |
| `stream.latency.from_accepted.p95` | number \| null | no | Null when n is 0. |

## Example request

```bash
curl -sS 'https://api.secblast.com/v3/coverage/summary'
```

[Open this route in the console](https://www.secblast.com/console#get-v3-coverage-summary)

## More in Coverage, usage and service

Previous: [`GET /v3/coverage/count`](https://www.secblast.com/docs/reference/get-coverage-count) · Next: [`GET /v3/forms`](https://www.secblast.com/docs/reference/get-forms)
