---
title: "Operations snapshot — recent ingestion runs, queue depth, parse errors, freshness"
method: GET
path: "/api/v1/coverage"
tags: ["discovery"]
---

# Operations snapshot — recent ingestion runs, queue depth, parse errors, freshness

`GET /api/v1/coverage`

## Request

- Base URL: `https://api.morvs.ai`
- URL: `https://api.morvs.ai/api/v1/coverage`
- Auth: none required

Table row counts and operational watermarks. freshness_by_topic is based on indexed documents, not a confirmed upstream source observation; use /api/v1/freshness for that distinction.

## Response `200`

Current ingestion and indexed-content operations snapshot

- CoverageSnapshot
  - `dataset_sizes` object, required: Current table row counts. These are not deduplicated source-record totals.
    - `documents` integer, required
    - `document_sections` integer, required
    - `sec_companies` integer, required
    - `sec_companies_tickered` integer, required
    - `sec_companies_enriched` integer, required
    - `sec_filings` integer, required
    - `sec_insider_transactions` integer, required
    - `sec_form144_notices` integer, required
    - `sec_holdings_13f` integer, required
    - `sec_nport_funds` integer, required
    - `sec_nport_holdings` integer, required
    - `sec_financial_facts` integer, required
    - `sec_financial_facts_companies` integer, required
    - `fda_recalls` integer, required
    - `fda_adverse_events` integer, required
    - `fda_510k` integer, required
    - `federal_register` integer, required
    - `weather_alerts` integer, required
    - `usgs_earthquakes` integer, required
  - `recent_runs` object[], required
    - `run_id` integer, required
    - `topic_key` string, required
    - `source` string, required
    - `status` 'running' | 'completed' | 'failed' | 'partial', required
    - `documents_discovered` integer, required
    - `documents_ingested` integer, required
    - `documents_failed` integer, required
    - `started_at` string, required: SQLite UTC timestamp (YYYY-MM-DD HH:MM:SS).
    - `completed_at` string, nullable, required: SQLite UTC timestamp, or null while unfinished.
    - `error_message` string, nullable, required
  - `unresolved_parse_errors` object[], required
    - `stage` string, required
    - `error_type` string, required
    - `n` integer, required
    - `last_occurred` string, required: SQLite UTC timestamp (YYYY-MM-DD HH:MM:SS).
  - `queue_depth_by_doc_type` object[], required
    - `doc_type` string, required
    - `pending` integer, required
  - `freshness_by_topic` object[], required: Indexed-document watermarks, not verified upstream source-observation times; see /api/v1/freshness.
    - `topic_key` string, required
    - `last_ingest` string, nullable, required: SQLite UTC indexed-document timestamp, if present.
    - `last_parse` string, nullable, required: SQLite UTC parsed-document timestamp, if present.

---

[API](https://skmtc.dev/morvs/apis/morvs-regulatory-and-public-data-hub.md) · [All operations](https://skmtc.dev/morvs/apis/morvs-regulatory-and-public-data-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/morvs/apis/morvs-regulatory-and-public-data-hub/revisions/16d40173b764?raw)
