---
title: "Get measured coverage and source provenance."
method: GET
path: "/api/v1/coverage"
tags: ["Coverage"]
---

# Get measured coverage and source provenance.

`GET /api/v1/coverage`

## Request

- Base URL: `https://www.veridionmarkets.com`
- URL: `https://www.veridionmarkets.com/api/v1/coverage`
- Auth: one of:
  - none
  - HTTP bearer

Counts and rates describing what Veridion has collected, not what it serves. Every rate names its own numerator and denominator fields inside its own object, so no ratio has to be inferred from two unrelated counts. `first_party_verified_rows` is a deprecated alias retained at its original value; prefer `first_party_verified_rows_including_superseded`. Neither is a live-row or served-row count. The legacy House PTR `rate` is held documents divided by published documents and does not describe the served corpus; use `served_rate` with its stated `rate_basis` for that. Accepts no query parameters.

## Response `200`

Coverage and provenance counts.

- PublicCoverage
  - `paper_transcriptions` object, required: Retained House paper PTR population, outstanding queue records, per-member projections and explicit reconciliation gaps. Transaction counts remain unknown before transcription.
    - `state` 'measured' | 'incomplete' | 'unavailable', required: Whether the retained annual index and complete PDF inspection population reconcile, remain incomplete, or cannot be read.
    - `reason` string, nullable, required: Named reason for incomplete or unavailable measurement; null only when reconciled.
    - `archive_year` integer, required: Clerk annual filing-index year being reconciled.
    - `measured_at` string, date-time, nullable, required: Database transaction timestamp from the same RPC statement as these counts, canonical UTC Z; null when the read could not complete.
    - `index_run_id` string, uuid, nullable, required: Latest completed retained Clerk-index run used for every denominator, or null when unavailable.
    - `index_fetched_at` string, date-time, nullable, required: Retained annual index fetch time, canonical UTC Z; not the queue measurement time.
    - `index_receipt` string, nullable, required: Official Clerk annual ZIP URL supporting the index denominator, or null when unavailable.
    - `index_ptr_documents` integer, nullable, required: Distinct PTR documents in the reconciled annual index; null without a complete retained denominator.
    - `inspected_documents` integer, nullable, required: Indexed documents with a matching successful all-pages inspection; null when the index cannot be reconciled.
    - `uninspected_documents` integer, nullable, required: Indexed documents lacking matching successful text-layer evidence; null when the index cannot be reconciled.
    - `paper_documents` integer, nullable, required: Total indexed no-text documents, including transcribed papers; null until every index document is inspected and queue metadata reconciles.
    - `pending_documents` integer, nullable, required: Total indexed PTRs awaiting verified transcription, including paper and deterministic parser outcomes; null when the inspection population is incomplete.
    - `terminal_documents` integer, nullable, required: Observed terminal transcription failures matched to the retained index; null when the index cannot be reconciled.
    - `transcribed_documents` integer, nullable, required: Indexed queue documents explicitly completed after a matching verified parse committed; null when the index cannot be reconciled.
    - `paper_rows_remaining` unknown, required
    - `paper_rows_reason` string, required: Reason a remaining transaction-row count is unavailable.
    - `diagnostics` object, required: Explicit reconciliation gaps. Missing evidence never becomes a zero count.
      - `invalid_index_rows` integer, nullable, required: Retained PTR manifest rows rejected for missing or conflicting receipt/date/member metadata; null when not examined.
      - `queue_metadata_mismatches` integer, nullable, required: Queue inspections whose receipt or filing date conflicts with the retained index; null when not examined.
      - `queue_documents_outside_index` integer, nullable, required: Observed paper-queue documents absent from the retained annual index; null when not examined.
    - `pending` object[], required: Index-reconciled filings awaiting verified transcription ranked by active consented follows, then filing date and DocID.
      - `doc_id` string, required: House Clerk PTR document identifier.
      - `member` string, required: Member name from retained Clerk filing metadata.
      - `member_id` string, required: Member route identifier, resolved through the existing member alias registry when available.
      - `filing_date` string, date, required: Filing date printed in the retained Clerk annual index, YYYY-MM-DD.
      - `receipt_url` string, required: Official Clerk PDF URL matching this DocID.
      - `state` 'pending_transcription', required: The filing has no completed verified transcription recorded in this queue.
      - `queue_status` 'pending_transcription' | 'failed_terminal', required: Outstanding transcription work or a retained terminal transcription failure.
      - `since` string, date-time, required: First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.
      - `since_basis` 'first_verified_no_text_inspection' | 'first_terminal_document_outcome', required: Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.
      - `reason` string, nullable, required: Named terminal queue diagnosis, or null when none is recorded.
      - `paper_rows` unknown, required
      - `paper_rows_reason` 'not_transcribed', required: Why no transaction-row count is available.
      - `active_followers` integer, nullable, required: Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured.
    - `unreconciled` object[], required: Outstanding queue records lacking matching current index evidence, retained visibly outside the reconciled denominator.
      - `doc_id` string, required: House Clerk PTR document identifier.
      - `member` string, required: Member name from retained Clerk filing metadata.
      - `member_id` string, required: Member route identifier, resolved through the existing member alias registry when available.
      - `filing_date` string, date, required: Filing date printed in the retained Clerk annual index, YYYY-MM-DD.
      - `receipt_url` string, required: Official Clerk PDF URL matching this DocID.
      - `state` 'pending_transcription', required: The filing has no completed verified transcription recorded in this queue.
      - `queue_status` 'pending_transcription' | 'failed_terminal', required: Outstanding transcription work or a retained terminal transcription failure.
      - `since` string, date-time, required: First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.
      - `since_basis` 'first_verified_no_text_inspection' | 'first_terminal_document_outcome', required: Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.
      - `reason` string, nullable, required: Named terminal queue diagnosis, or null when none is recorded.
      - `paper_rows` unknown, required
      - `paper_rows_reason` 'not_transcribed', required: Why no transaction-row count is available.
      - `active_followers` integer, nullable, required: Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured.
    - `by_member` object[], required: Per-member projections of this same queue measurement, without additional database reads.
      - `member_id` string, required: Canonical member identifier requested by the member surface.
      - `measured_at` string, date-time, nullable, required: Timestamp inherited from the same coverage/counts RPC, canonical UTC Z; null when the read could not complete.
      - `state` 'pending_transcription', nullable, required: Pending transcription when at least one observed outstanding queue document exists; otherwise null, not a completeness claim.
      - `pending_documents` integer, nullable, required: Member's total outstanding queue filings only when the full annual population is measured; otherwise null.
      - `known_pending_documents` integer, nullable, required: Observed outstanding queue records for this member, including unreconciled records; null when coverage is unavailable, and never a count of the uninspected population.
      - `pending_documents_reason` string, nullable, required: Reason the member total is unknown, inherited from the same coverage measurement.
      - `paper_rows_remaining` unknown, required
      - `paper_rows_reason` 'not_transcribed', required: Why the member's remaining transaction-row count is unavailable.
      - `pending` object[], required: Observed pending and terminal paper-queue filings for this member, including records whose index reconciliation is incomplete.
        - `doc_id` string, required: House Clerk PTR document identifier.
        - `member` string, required: Member name from retained Clerk filing metadata.
        - `member_id` string, required: Member route identifier, resolved through the existing member alias registry when available.
        - `filing_date` string, date, required: Filing date printed in the retained Clerk annual index, YYYY-MM-DD.
        - `receipt_url` string, required: Official Clerk PDF URL matching this DocID.
        - `state` 'pending_transcription', required: The filing has no completed verified transcription recorded in this queue.
        - `queue_status` 'pending_transcription' | 'failed_terminal', required: Outstanding transcription work or a retained terminal transcription failure.
        - `since` string, date-time, required: First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.
        - `since_basis` 'first_verified_no_text_inspection' | 'first_terminal_document_outcome', required: Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.
        - `reason` string, nullable, required: Named terminal queue diagnosis, or null when none is recorded.
        - `paper_rows` unknown, required
        - `paper_rows_reason` 'not_transcribed', required: Why no transaction-row count is available.
        - `active_followers` integer, nullable, required: Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured.
  - `dataset` 'veridion-disclosure-api', required
  - `version` 'v1-preview', required
  - `generated_at` string, date-time, required
  - `cache` object, required
    - `policy` 'no-store', required: The cache contract this response was served under; always no-store for a measurement. Rendered as Cache-Control: no-store, max-age=0 with CDN-Cache-Control and Vercel-CDN-Cache-Control: no-store, and echoed in X-Veridion-Cache-Policy.
    - `browser_max_age_seconds` 0, required: Seconds a browser or client cache may reuse this body without revalidating; 0, the max-age the Cache-Control header carries.
    - `cdn_max_age_seconds` 0, required: Seconds the CDN may reuse this body; 0, because CDN-Cache-Control is no-store. Public record responses declare a nonzero value here; measurements never do.
    - `declared_max_staleness_seconds` 0, required: The upper bound on how old this body can be when it reaches a client, counted from generated_at; 0 for a measurement, and the same number the X-Veridion-Cache-Max-Staleness header carries.
    - `age_header` unknown, required
  - `description` string, required
  - `serving` object, required: Rows /v1/disclosures returns right now, counted from the serving view at read time after every exclusion. Not the count of rows that qualify. Every count is nullable because the measurement reports unavailable rather than guessing when it cannot reach the view.
    - `state` 'measured' | 'unavailable', required
    - `measured_at` string, date-time, required
    - `basis` string, required
    - `total_rows` integer, nullable, required: Exact count of active serving versions (valid_to is null), excluding closed versions. Separate read from the source and chamber counts, not a generation-pinned census; null if unavailable.
    - `by_source_system` object, required
      - `house_clerk` integer, nullable, required: Active serving versions whose source_system is house_clerk; closed versions excluded, separate exact-count read, null if unavailable.
      - `senate_efd` integer, nullable, required: Active serving versions whose source_system is senate_efd; closed versions excluded, separate exact-count read, null if unavailable.
      - `oge` integer, nullable, required: Active serving versions whose source_system is oge; closed versions excluded, separate exact-count read, null if unavailable.
    - `by_chamber` object, required
      - `house` integer, nullable, required: Active serving versions whose chamber is house; closed versions excluded, separate exact-count read, null if unavailable.
      - `senate` integer, nullable, required: Active serving versions whose chamber is senate; closed versions excluded, separate exact-count read, null if unavailable.
      - `executive` integer, nullable, required: Active serving versions whose chamber is executive; closed versions excluded, separate exact-count read, null if unavailable.
  - `congress` union, required
    - object
      - `population_basis` string, required: All retained congressional warehouse rows, including superseded rows and all collection channels, counted by the persisted summary at measured_at; not currently live rows or rows served by the API. last_90_days additionally requires publishable dates and a transaction or filing date within the summary's 90-day lookback; it still includes superseded rows. This block excludes OGE and SEC.
      - `measured_at` string, date-time, nullable, required
      - `as_of` string, date-time, nullable, required
      - `age_seconds` number, nullable, required: Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp.
      - `expected_max_age_seconds` number, required: Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.
      - `threshold_basis` string, required
      - `detail` string, nullable, required
      - `state` 'ready', required
      - `warehouse_rows` integer, required: All retained congressional warehouse rows across all collection channels. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `unique_members` integer, required: Distinct nonempty member identifiers, using member_slug or the summary's normalized member-name fallback. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `unique_tickers` integer, required: Distinct nonempty ticker strings after trimming and uppercasing; not a count of resolved issuers. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `unique_filings` integer, required: Distinct trimmed HTTPS document URL strings, not distinct document IDs and not a URL-resolution test. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `first_party_verified_rows_including_superseded` integer, required: Retained congressional warehouse rows marked receipt-linked by Veridion, including superseded rows. The summary asserts equality to the first-party collection-channel count; this is not a live-row or served-row count.
      - `first_party_verified_rows` integer, required: Deprecated compatibility alias for first_party_verified_rows_including_superseded. Retained receipt-linked congressional warehouse rows including superseded rows, not live or served rows; the value is unchanged.
      - `licensed_feed_document_reference_rows` integer, required: Retained congressional warehouse rows without a first-party receipt-link marker but with a trimmed valid HTTPS document URL. Includes superseded rows; the name does not establish collection-channel identity or URL liveness.
      - `licensed_feed_rows` integer, required: Deprecated compatibility alias for licensed_feed_document_reference_rows: retained rows without a first-party receipt-link marker but with a valid HTTPS URL, including superseded rows. Not the total licensed-feed population.
      - `no_document_reference_rows` integer, required: Rows with neither a first-party receipt-link marker nor a valid trimmed HTTPS document URL. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `document_reference_definitions` object, required
        - `first_party_verified_rows` string, required
        - `first_party_verified_rows_including_superseded` string, required: Definition of the retained receipt-marker count, explicitly including superseded rows; carried in the payload so its population does not depend on consulting external documentation.
        - `licensed_feed_document_reference_rows` string, required
        - `licensed_feed_rows` string, required
        - `no_document_reference_rows` string, required
      - `receipt_linked_rows` integer, required: Deprecated count of retained rows with a valid trimmed HTTPS document URL, including superseded rows. Not evidence of a first-party retrieval or a resolved URL.
      - `deprecated_fields` string[], required
      - `field_successors` object, required
        - `first_party_verified_rows` 'first_party_verified_rows_including_superseded', required: Replacement field for the deprecated first_party_verified_rows alias; both names return the same retained count, not a newly measured live count.
        - `licensed_feed_rows` 'licensed_feed_document_reference_rows', required
      - `amount_disclosed_rows` integer, required: Rows with amount_mid, or both amount_low and amount_high from which the summary derives a midpoint; not a count of exact transaction values. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `amount_disclosed_pct` number, nullable, required: 100 times amount_disclosed_rows divided by warehouse_rows, rounded to one decimal place; null for zero warehouse rows. Both counts include superseded rows.
      - `by_chamber` object, required
        - `house` object, required
          - `rows` integer, required: Rows with warehouse chamber exactly House. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
          - `amount_disclosed_rows` integer, required: House rows with amount_mid or both amount bounds; subset of by_chamber.house.rows. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
        - `senate` object, required
          - `rows` integer, required: Rows with warehouse chamber exactly Senate. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
          - `amount_disclosed_rows` integer, required: Senate rows with amount_mid or both amount bounds; subset of by_chamber.senate.rows. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `last_90_days` object, required
        - `rows` integer, required: Rows passing the summary's publishable-date predicate with transaction_date or filing_date on or after the summary date minus 90 days. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
        - `unique_filings` integer, required: Distinct valid trimmed HTTPS document URL strings among last_90_days.rows; not distinct document IDs or live URLs. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
        - `unique_members` integer, required: Distinct nonempty canonical member identifiers among last_90_days.rows, using member_slug or the summary's normalized name fallback. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
    - object
      - `population_basis` string, required: All retained congressional warehouse rows, including superseded rows and all collection channels, counted by the persisted summary at measured_at; not currently live rows or rows served by the API. last_90_days additionally requires publishable dates and a transaction or filing date within the summary's 90-day lookback; it still includes superseded rows. This block excludes OGE and SEC.
      - `measured_at` string, date-time, nullable, required
      - `as_of` string, date-time, nullable, required
      - `age_seconds` number, nullable, required: Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp.
      - `expected_max_age_seconds` number, required: Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.
      - `threshold_basis` string, required
      - `detail` string, nullable, required
      - `state` 'stale', required
    - object
      - `population_basis` string, required: All retained congressional warehouse rows, including superseded rows and all collection channels, counted by the persisted summary at measured_at; not currently live rows or rows served by the API. last_90_days additionally requires publishable dates and a transaction or filing date within the summary's 90-day lookback; it still includes superseded rows. This block excludes OGE and SEC.
      - `measured_at` string, date-time, nullable, required
      - `as_of` string, date-time, nullable, required
      - `age_seconds` number, nullable, required: Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp.
      - `expected_max_age_seconds` number, required: Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.
      - `threshold_basis` string, required
      - `detail` string, nullable, required
      - `state` 'unavailable', required
  - `provenance` object, required
    - `state` 'measured' | 'unavailable', required
    - `population_basis` string, required: All retained congressional warehouse rows, including superseded rows, counted by current collection labels and URL substrings in separate reads at measured_at. These are not live-row or served-row counts, not an atomic snapshot, and not a receipt-resolution test. OGE and SEC are outside this population.
    - `total_rows` integer, nullable, required: All retained congressional warehouse rows across all collection channels. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
    - `measured_at` string, date-time, required
    - `by_collection_channel` object, required
      - `house_clerk_direct_ocr` integer, nullable, required: Rows carrying the first-party House parser collection label. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
      - `senate_efd_direct` integer, nullable, required: Rows carrying the first-party Senate eFD collection label. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
      - `licensed_bulk_feed` integer, nullable, required: Sum of the two licensed-provider collection-label counts; null if either read failed. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
    - `self_collected_rows` integer, nullable, required: Sum of House parser and Senate eFD collection-label counts; null if either read failed. This is collection provenance, not serving admission. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
    - `licensed_feed_rows_total` integer, nullable, required: Sum of the two licensed-provider collection-label counts, including superseded rows and rows without a document URL. Separate retained-warehouse reads, not a served count; null if either read failed.
    - `third_party_rows` integer, nullable, required: Deprecated compatibility alias for licensed_feed_rows_total: sum of the licensed-provider collection-label counts, including superseded rows; null if either read failed. Not a served count.
    - `unattributed_rows` integer, nullable, required: Maximum of zero and total_rows minus self_collected_rows minus licensed_feed_rows_total; null if any input is unavailable. Arithmetic remainder, not a separate label census. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
    - `deprecated_fields` string[], required
    - `field_successors` object, required
      - `third_party_rows` 'licensed_feed_rows_total', required
    - `by_receipt_office` object, required
      - `us_house_clerk` integer, nullable, required: Rows whose pdf_url contains disclosures-clerk.house.gov, case-insensitive. Substring test only, not validated hostname, first-party retrieval or URL resolution. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
      - `us_senate_efd` integer, nullable, required: Rows whose pdf_url contains senate.gov, case-insensitive. Substring test only, not validated hostname, first-party retrieval or URL resolution. Includes superseded congressional warehouse rows; separate exact-count read, null on read failure. Not a served count.
  - `provenance_field_coverage` union, required
    - object
      - `state` 'measured', required
      - `population_basis` string, required: Active House Clerk and Senate eFD serving versions with valid_to unset; closed versions are excluded. Counts are separate reads, not a generation-pinned snapshot. The bounded parser-gap register must contain every counted parser gap or rates are withheld. These counts do not test URL resolution.
      - `measured_at` string, date-time, required
      - `rows_examined` integer, required: Sum of the House and Senate active-version examined counts. OGE, SEC and closed temporal versions are excluded; not independent document count.
      - `fields` object[], required
        - `source_system` 'house_clerk' | 'senate_efd', required
        - `field` 'source_line_number', required
        - `populated` integer, required: Active serving versions for this source with source_line_number non-null. Closed versions are excluded; counts a field, not a resolved receipt URL.
        - `examined` integer, required: All active serving versions for this source with valid_to unset. The rate denominator; separate from warehouse history including superseded rows.
        - `rate` number, required: populated divided by examined. The integer denominator and numerator remain authoritative.
        - `null_interpretation` 'gap' | 'not_applicable', required
        - `rate_basis` object, required: Names the counts behind each published field-coverage rate in this same object.
          - `rate` object, required: Machine-readable division rule for the sibling rate.
            - `numerator` 'populated', required: The populated sibling count supplies this rate's numerator.
            - `denominator` 'examined', required: The examined sibling count supplies this rate's denominator.
        - `reason` string, required
      - `house_clerk_gap_classes` object[], required
        - `reason` 'warehouse_fallback_without_line_provenance' | 'parser_output_without_line_provenance', required
        - `affected_rows` integer, required: Active House serving rows with null source_line_number in this reason class: fallback parser or named parser output. Closed versions excluded; both classes must sum to the House field gap.
        - `classification` string, required
      - `house_clerk_gap_register` object[], required
        - `document_id` string, required
        - `affected_rows` integer, required: Active House serving rows in the complete bounded parser-gap read for this document, with a named non-fallback parser but null source_line_number; closed versions excluded.
        - `parser_versions` string[], required
        - `reason` 'parser_output_without_line_provenance', required
      - `detail` unknown, required
    - object
      - `state` 'unavailable', required
      - `population_basis` string, required: Active House Clerk and Senate eFD serving versions with valid_to unset; closed versions are excluded. Counts are separate reads, not a generation-pinned snapshot. The bounded parser-gap register must contain every counted parser gap or rates are withheld. These counts do not test URL resolution.
      - `measured_at` string, date-time, required
      - `rows_examined` integer, required: Active House plus Senate row counts when both were measured before a later validation failed; zero is also the legacy no-examination sentinel, not evidence of an empty corpus. Rates are withheld.
      - `fields` object[], required
        - `source_system` 'house_clerk' | 'senate_efd', required
        - `field` 'source_line_number', required
        - `populated` integer, required: Active serving versions for this source with source_line_number non-null. Closed versions are excluded; counts a field, not a resolved receipt URL.
        - `examined` integer, required: All active serving versions for this source with valid_to unset. The rate denominator; separate from warehouse history including superseded rows.
        - `rate` number, required: populated divided by examined. The integer denominator and numerator remain authoritative.
        - `null_interpretation` 'gap' | 'not_applicable', required
        - `rate_basis` object, required: Names the counts behind each published field-coverage rate in this same object.
          - `rate` object, required: Machine-readable division rule for the sibling rate.
            - `numerator` 'populated', required: The populated sibling count supplies this rate's numerator.
            - `denominator` 'examined', required: The examined sibling count supplies this rate's denominator.
        - `reason` string, required
      - `house_clerk_gap_classes` object[], required
        - `reason` 'warehouse_fallback_without_line_provenance' | 'parser_output_without_line_provenance', required
        - `affected_rows` integer, required: Active House serving rows with null source_line_number in this reason class: fallback parser or named parser output. Closed versions excluded; both classes must sum to the House field gap.
        - `classification` string, required
      - `house_clerk_gap_register` object[], required
        - `document_id` string, required
        - `affected_rows` integer, required: Active House serving rows in the complete bounded parser-gap read for this document, with a named non-fallback parser but null source_line_number; closed versions excluded.
        - `parser_versions` string[], required
        - `reason` 'parser_output_without_line_provenance', required
      - `detail` string, required
  - `house_clerk_ptr_completeness` union, required: Held and served coverage from one completed House Clerk PTR index run, both read through the same funnel helper as /data-api. Aggregate rates are withheld if archive-year totals disagree with distinct indexed documents. These are archive-year scopes, not filing-date buckets. Every rate names its sibling numerator and denominator in rate_basis. House PTR type P only, for the stated archive years; not Senate eFD, other filing types, or a claim that the Clerk's index is complete. measurement_definition carries this boundary even when counts are unavailable.
    - object
      - `series` object, required: Private append-only reconciliation-run history exposed as document counts and explicit gaps. Historical replays are labeled separately from contemporaneous captures.
        - `state` 'measured' | 'unavailable', required: Whether the series reader succeeded, not whether the live funnel is fresh or every historical run has a point.
        - `entries` union[], required: One entry per completed run, oldest first. Absent entries mark gaps explicitly; no interpolation or silent zero filling.
          - union
            - object
              - …
            - object
              - …
        - `reason` string, nullable, required: Series-level read or validation refusal; null for a successful read, even if some historical entries are absent.
      - `run_id` string, nullable, required: The completed reconciliation selected by the shared funnel RPC; every archive-year count uses this run, never a union of runs.
      - `served_measured_at` string, date-time, nullable, required: Database statement instant for the active-version count. measured_at separately records when the held/index reconciliation completed; these instants are not interchangeable.
      - `clerk_published_documents` integer, nullable, required: Sum of published PTR DocIDs across the twelve archive years in the selected completed run, emitted only after equality with its distinct indexed DocID count is verified.
      - `documents_held` integer, nullable, required: Sum of the selected run's held-document counts. A held PDF need not yield a row the API admits; use documents_served for that stage.
      - `documents_served` integer, nullable, required: Distinct indexed House PTR DocIDs with an active house_clerk version at served_measured_at, restricted to this reconciliation run and, for a yearly entry, its archive year. Null when any stage cannot be verified.
      - `held_rate` number, nullable, required: documents_held divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Acquisition coverage, not what disclosures returns. Null when the complete funnel cannot be measured.
      - `served_rate` number, nullable, required: documents_served divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Measures API document coverage, not held coverage. Null when the complete funnel cannot be measured.
      - `rate_basis` object, required: Both rates divide their named document count by the published count in this object; ratios are 0 to 1, not percentages.
        - `held_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
          - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
          - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
        - `served_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
          - `numerator` 'documents_served', required: Name of the sibling document count divided to produce this rate.
          - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
      - `state` 'measured', required
      - `measured_at` string, date-time, required
      - `age_seconds` integer, required: Elapsed nonnegative seconds since completion of the selected index reconciliation, not since response generation or the serving read.
      - `expected_max_age_seconds` 172800, required: Configured maximum reconciliation age in seconds before document counts are withheld.
      - `rows_examined` integer, required: Sum of indexed PTR DocIDs examined across the selected run's archive years, asserted to match the published-document total; not transaction rows.
      - `source_year_start` 2015, required: First configured Clerk archive year included in this complete-run measurement.
      - `source_year_end` 2026, required: Last configured Clerk archive year included in this complete-run measurement.
      - `source_years` 12, required: Configured number of required archive years, source_year_end minus source_year_start plus one; all must reconcile before counts publish.
      - `measurement_definition` string, required
      - `missing_document_ids_retained` true, required
      - `years` object[], required
        - `year` integer, required: Annual Clerk archive year selected in the completed reconciliation, not the transaction year or filing-date bucket.
        - `state` 'measured', required
        - `rows_examined` integer, required: Indexed PTR DocIDs examined for this archive year in the selected completed run; asserted equal to clerk_published_documents, not parsed transaction rows.
        - `clerk_published_documents` integer, required: PTR DocIDs on this archive year's official index in the selected completed run. Denominator is filed documents, not warehouse rows or all historical index runs.
        - `documents_held` integer, required: Indexed PTR DocIDs matched to held documents in this archive year and run, regardless of whether any transaction row is served.
        - `documents_missing` integer, required: clerk_published_documents minus documents_held in this archive year and run, reconciled to the missing-reason document counts.
        - `documents_served` integer, nullable, required: Distinct indexed House PTR DocIDs with an active house_clerk version at served_measured_at, restricted to this reconciliation run and, for a yearly entry, its archive year. Null when any stage cannot be verified.
        - `held_rate` number, nullable, required: documents_held divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Acquisition coverage, not what disclosures returns. Null when the complete funnel cannot be measured.
        - `served_rate` number, nullable, required: documents_served divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Measures API document coverage, not held coverage. Null when the complete funnel cannot be measured.
        - `rate_basis` object, required: The legacy rate is a held-rate alias, not a served rate; every divisor and dividend is named here.
          - `held_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
          - `served_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_served', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
          - `rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
        - `rate` number, required: documents_held divided by clerk_published_documents for this archive year. Counts are authoritative; a value of 1 is emitted only when documents_missing is exactly zero.
        - `missing_by_classification` object, required
          - `never_attempted` integer, required: Missing indexed PTR DocIDs with no recorded retrieval attempt in the selected reconciliation year. Document count, not warehouse row count; no superseded-row filter applies.
          - `attempted_failed` integer, required: Missing indexed PTR DocIDs with recorded retrieval attempts and no held match in the selected reconciliation year. Document count; no superseded-row filter applies.
          - `present_under_different_identifier` integer, required: Missing indexed PTR DocIDs classified by the reconciliation as held under another identifier for this archive year. Document count, not admitted rows; no superseded-row filter applies.
        - `detail` unknown, required
      - `detail` unknown, required
    - object
      - `series` object, required: Private append-only reconciliation-run history exposed as document counts and explicit gaps. Historical replays are labeled separately from contemporaneous captures.
        - `state` 'measured' | 'unavailable', required: Whether the series reader succeeded, not whether the live funnel is fresh or every historical run has a point.
        - `entries` union[], required: One entry per completed run, oldest first. Absent entries mark gaps explicitly; no interpolation or silent zero filling.
          - union
            - object
              - …
            - object
              - …
        - `reason` string, nullable, required: Series-level read or validation refusal; null for a successful read, even if some historical entries are absent.
      - `run_id` string, nullable, required: The completed reconciliation selected by the shared funnel RPC; every archive-year count uses this run, never a union of runs.
      - `served_measured_at` string, date-time, nullable, required: Database statement instant for the active-version count. measured_at separately records when the held/index reconciliation completed; these instants are not interchangeable.
      - `clerk_published_documents` integer, nullable, required: Sum of published PTR DocIDs across the twelve archive years in the selected completed run, emitted only after equality with its distinct indexed DocID count is verified.
      - `documents_held` integer, nullable, required: Sum of the selected run's held-document counts. A held PDF need not yield a row the API admits; use documents_served for that stage.
      - `documents_served` integer, nullable, required: Distinct indexed House PTR DocIDs with an active house_clerk version at served_measured_at, restricted to this reconciliation run and, for a yearly entry, its archive year. Null when any stage cannot be verified.
      - `held_rate` number, nullable, required: documents_held divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Acquisition coverage, not what disclosures returns. Null when the complete funnel cannot be measured.
      - `served_rate` number, nullable, required: documents_served divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Measures API document coverage, not held coverage. Null when the complete funnel cannot be measured.
      - `rate_basis` object, required: Both rates divide their named document count by the published count in this object; ratios are 0 to 1, not percentages.
        - `held_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
          - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
          - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
        - `served_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
          - `numerator` 'documents_served', required: Name of the sibling document count divided to produce this rate.
          - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
      - `state` 'unevaluated', required
      - `measured_at` unknown, required
      - `age_seconds` unknown, required
      - `expected_max_age_seconds` 172800, required: Configured maximum reconciliation age in seconds, even when no eligible measurement is available.
      - `rows_examined` 0, required: No complete verified reconciliation examination; sentinel zero is not a measured empty index. Funnel counts and rates are null.
      - `source_year_start` 2015, required: First configured archive year required for a complete reconciliation, not proof that its index was fetched.
      - `source_year_end` 2026, required: Last configured archive year required for a complete reconciliation, not proof that its index was fetched.
      - `source_years` 12, required: Configured required archive-year count, source_year_end minus source_year_start plus one; not successfully measured years.
      - `measurement_definition` string, required
      - `missing_document_ids_retained` unknown, required
      - `years` object[], required
        - `year` integer, required: Configured Clerk archive year awaiting measurement, not an observed transaction or filing year.
        - `state` 'unevaluated', required
        - `rows_examined` 0, required: No verified document examination for this archive year; sentinel zero is not a measured empty index. Document counts are null.
        - `clerk_published_documents` unknown, required
        - `documents_held` unknown, required
        - `documents_missing` unknown, required
        - `documents_served` integer, nullable, required: Distinct indexed House PTR DocIDs with an active house_clerk version at served_measured_at, restricted to this reconciliation run and, for a yearly entry, its archive year. Null when any stage cannot be verified.
        - `held_rate` number, nullable, required: documents_held divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Acquisition coverage, not what disclosures returns. Null when the complete funnel cannot be measured.
        - `served_rate` number, nullable, required: documents_served divided by clerk_published_documents, to twelve fractional places; the integer counts are authoritative. Measures API document coverage, not held coverage. Null when the complete funnel cannot be measured.
        - `rate_basis` object, required: The legacy rate is a held-rate alias, not a served rate; every divisor and dividend is named here.
          - `held_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
          - `served_rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_served', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
          - `rate` object, required: Machine-readable division rule; both referenced fields occur in this same coverage object.
            - `numerator` 'documents_held', required: Name of the sibling document count divided to produce this rate.
            - `denominator` 'clerk_published_documents', required: Name of the sibling Clerk-index document count used as the denominator, never the held count.
        - `rate` unknown, required
        - `missing_by_classification` unknown, required
        - `detail` string, required
      - `detail` string, required
  - `provenance_reconciliation` union, required
    - object
      - `state` 'reconciled', required
      - `population_basis` string, required: Arithmetic reconciliation of the two retained congressional warehouse partitions, both including superseded rows, at their separately reported measurement timestamps. Matching totals are not proof of row-level identity or an explanation of the warehouse-to-serving gap. Unavailable bridge counts are withheld.
      - `rows_examined` integer, required: Retained congressional warehouse rows in the collection-channel total, including superseded rows, after arithmetic agreement with the separately timed summary; not a row-level join.
      - `measurement_timestamps` object, required
        - `receipt_reference` string, date-time, required
        - `collection_ownership` string, date-time, required
      - `licensed_feed_rows_total` integer, required: Collection-channel licensed total carried from provenance after the two partitions reconcile; independently timed measurement. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `licensed_feed_document_reference_rows` integer, required: Summary count without a first-party receipt-link marker but with a valid HTTPS URL, carried after arithmetic reconciliation; not a row-level collection-channel match. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `licensed_feed_rows_without_document_reference` integer, required: licensed_feed_rows_total minus licensed_feed_document_reference_rows after partition checks; an arithmetic bridge, not a joined row census. Includes superseded warehouse rows at the summary measurement, not only live or served rows.
      - `licensed_feed_rows_without_document_reference_pct_of_licensed_feed` number, nullable, required: 100 times licensed_feed_rows_without_document_reference divided by licensed_feed_rows_total, rounded to one decimal place; null for zero denominator. Both include superseded rows.
      - `licensed_feed_rows_without_document_reference_pct_of_warehouse` number, nullable, required: 100 times licensed_feed_rows_without_document_reference divided by rows_examined, rounded to one decimal place; null for zero denominator. Both include superseded rows.
      - `reason` string, required
      - `relationships` string[], required
      - `detail` unknown, required
    - object
      - `state` 'unavailable', required
      - `population_basis` string, required: Arithmetic reconciliation of the two retained congressional warehouse partitions, both including superseded rows, at their separately reported measurement timestamps. Matching totals are not proof of row-level identity or an explanation of the warehouse-to-serving gap. Unavailable bridge counts are withheld.
      - `rows_examined` integer, required: Available retained collection total, else available summary warehouse total, else the legacy zero sentinel for an unmeasured population. Includes superseded rows when measured; zero here does not establish an empty warehouse.
      - `measurement_timestamps` object, required
        - `receipt_reference` string, date-time, nullable, required
        - `collection_ownership` string, date-time, required
      - `detail` string, required
  - `sources_of_record` object[], required
    - `office` string, required
    - `url` string, uri, required
    - `publishing` boolean, required: Whether this office publishes rows into v1 today. sec_edgar is listed and false: it is the declared scope boundary, not an omission. A reader should learn the boundary from the response rather than infer it from a query that returns nothing.
  - `exclusions` string[], required
  - `notice` string, required
  - `request_access` string, uri, required

## Other responses

- `400`: This endpoint accepts no query parameters.
- `401`: The supplied bearer key is invalid.
- `403`: The supplied key is not scoped for coverage.

---

[API](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api.md) · [All operations](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api/revisions/af69a5d7354e?raw)