get_coverage
Read-onlyIdempotent
Live coverage counts (rows, filers, per-source totals) measured from the serving views at request time.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Veridion Disclosures
Schema Changelog
Changes observed during successful MCP inspections.
Changed1 schema field changed
- changed
Output schema / (root)Previous value: -{ - "additionalProperties": false, - "properties": { - "cache": { - "additionalProperties": false, - "properties": { - "age_header": { - "description": "The name of the response header that reports how long a cache held this body, or null when no cache is permitted to hold it, as here. Public record responses name the Age header.", - "type": "null" - }, - "browser_max_age_seconds": { - "const": 0, - "description": "Seconds a browser or client cache may reuse this body without revalidating; 0, the max-age the Cache-Control header carries.", - "type": "number" - }, - "cdn_max_age_seconds": { - "const": 0, - "description": "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.", - "type": "number" - }, - "declared_max_staleness_seconds": { - "const": 0, - "description": "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.", - "type": "number" - }, - "policy": { - "const": "no-store", - "description": "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.", - "type": "string" - } - }, - "required": [ - "policy", - "browser_max_age_seconds", - "cdn_max_age_seconds", - "declared_max_staleness_seconds", - "age_header" - ], - "type": "object" - }, - "congress": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "age_seconds": { - "anyOf": [ - { - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp." - }, - "amount_disclosed_pct": { - "description": "100 times amount_disclosed_rows divided by warehouse_rows, rounded to one decimal place; null for zero warehouse rows. Both counts include superseded rows.", - "type": [ - "number", - "null" - ] - }, - "amount_disclosed_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "as_of": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "by_chamber": { - "additionalProperties": false, - "properties": { - "house": { - "additionalProperties": false, - "properties": { - "amount_disclosed_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "rows": { - "description": "Rows with warehouse chamber exactly House. Includes superseded warehouse rows at the summary measurement, not only live or served rows.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - } - }, - "required": [ - "rows", - "amount_disclosed_rows" - ], - "type": "object" - }, - "senate": { - "additionalProperties": false, - "properties": { - "amount_disclosed_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "rows": { - "description": "Rows with warehouse chamber exactly Senate. Includes superseded warehouse rows at the summary measurement, not only live or served rows.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - } - }, - "required": [ - "rows", - "amount_disclosed_rows" - ], - "type": "object" - } - }, - "required": [ - "house", - "senate" - ], - "type": "object" - }, - "deprecated_fields": { - "items": { - "type": "string" - }, - "type": "array" - }, - "detail": { - "type": [ - "string", - "null" - ] - }, - "document_reference_definitions": { - "additionalProperties": false, - "properties": { - "first_party_verified_rows": { - "minLength": 1, - "type": "string" - }, - "first_party_verified_rows_including_superseded": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "licensed_feed_document_reference_rows": { - "minLength": 1, - "type": "string" - }, - "licensed_feed_rows": { - "minLength": 1, - "type": "string" - }, - "no_document_reference_rows": { - "minLength": 1, - "type": "string" - } - }, - "required": [ - "first_party_verified_rows", - "first_party_verified_rows_including_superseded", - "licensed_feed_document_reference_rows", - "licensed_feed_rows", - "no_document_reference_rows" - ], - "type": "object" - }, - "expected_max_age_seconds": { - "description": "Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.", - "minimum": 0, - "type": "number" - }, - "field_successors": { - "additionalProperties": false, - "properties": { - "first_party_verified_rows": { - "const": "first_party_verified_rows_including_superseded", - "description": "Replacement field for the deprecated first_party_verified_rows alias; both names return the same retained count, not a newly measured live count.", - "type": "string" - }, - "licensed_feed_rows": { - "const": "licensed_feed_document_reference_rows", - "type": "string" - } - }, - "required": [ - "first_party_verified_rows", - "licensed_feed_rows" - ], - "type": "object" - }, - "first_party_verified_rows": { - "deprecated": true, - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer", - "x-veridion-successor": "first_party_verified_rows_including_superseded" - }, - "first_party_verified_rows_including_superseded": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "last_90_days": { - "additionalProperties": false, - "properties": { - "rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "unique_filings": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "unique_members": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - } - }, - "required": [ - "rows", - "unique_filings", - "unique_members" - ], - "type": "object" - }, - "licensed_feed_document_reference_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "licensed_feed_rows": { - "deprecated": true, - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer", - "x-veridion-successor": "licensed_feed_document_reference_rows" - }, - "measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "no_document_reference_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "receipt_linked_rows": { - "deprecated": true, - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "state": { - "const": "ready", - "type": "string" - }, - "threshold_basis": { - "minLength": 1, - "type": "string" - }, - "unique_filings": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "unique_members": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "unique_tickers": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "warehouse_rows": { - "description": "All retained congressional warehouse rows across all collection channels. Includes superseded warehouse rows at the summary measurement, not only live or served rows.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - } - }, - "required": [ - "population_basis", - "measured_at", - "as_of", - "age_seconds", - "expected_max_age_seconds", - "threshold_basis", - "detail", - "state", - "warehouse_rows", - "unique_members", - "unique_tickers", - "unique_filings", - "first_party_verified_rows_including_superseded", - "first_party_verified_rows", - "licensed_feed_document_reference_rows", - "licensed_feed_rows", - "no_document_reference_rows", - "document_reference_definitions", - "receipt_linked_rows", - "deprecated_fields", - "field_successors", - "amount_disclosed_rows", - "amount_disclosed_pct", - "by_chamber", - "last_90_days" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "age_seconds": { - "anyOf": [ - { - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp." - }, - "as_of": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "detail": { - "type": [ - "string", - "null" - ] - }, - "expected_max_age_seconds": { - "description": "Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.", - "minimum": 0, - "type": "number" - }, - "measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "state": { - "const": "stale", - "type": "string" - }, - "threshold_basis": { - "minLength": 1, - "type": "string" - } - }, - "required": [ - "population_basis", - "measured_at", - "as_of", - "age_seconds", - "expected_max_age_seconds", - "threshold_basis", - "detail", - "state" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "age_seconds": { - "anyOf": [ - { - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "Nonnegative whole seconds from summary measured_at to response generation; null without a valid summary timestamp." - }, - "as_of": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "detail": { - "type": [ - "string", - "null" - ] - }, - "expected_max_age_seconds": { - "description": "Configured six-hour operational budget for the four-hour summary job, in seconds; not a measured count or contractual service commitment.", - "minimum": 0, - "type": "number" - }, - "measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "state": { - "const": "unavailable", - "type": "string" - }, - "threshold_basis": { - "minLength": 1, - "type": "string" - } - }, - "required": [ - "population_basis", - "measured_at", - "as_of", - "age_seconds", - "expected_max_age_seconds", - "threshold_basis", - "detail", - "state" - ], - "type": "object" - } - ] - }, - "dataset": { - "const": "veridion-disclosure-api", - "type": "string" - }, - "description": { - "minLength": 1, - "type": "string" - }, - "exclusions": { - "items": { - "minLength": 1, - "type": "string" - }, - "type": "array" - }, - "generated_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "house_clerk_ptr_completeness": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "age_seconds": { - "description": "Elapsed nonnegative seconds since completion of the selected index reconciliation, not since response generation or the serving read.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "clerk_published_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "detail": { - "type": "null" - }, - "documents_held": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "expected_max_age_seconds": { - "const": 172800, - "description": "Configured maximum reconciliation age in seconds before document counts are withheld.", - "type": "number" - }, - "held_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "measured_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "measurement_definition": { - "minLength": 1, - "type": "string" - }, - "missing_document_ids_retained": { - "const": true, - "type": "boolean" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Both rates divide their named document count by the published count in this object; ratios are 0 to 1, not percentages.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate" - ], - "type": "object" - }, - "rows_examined": { - "description": "Sum of indexed PTR DocIDs examined across the selected run's archive years, asserted to match the published-document total; not transaction rows.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "run_id": { - "anyOf": [ - { - "minLength": 1, - "type": "string" - }, - { - "type": "null" - } - ], - "description": "The completed reconciliation selected by the shared funnel RPC; every archive-year count uses this run, never a union of runs." - }, - "series": { - "additionalProperties": false, - "description": "Private append-only reconciliation-run history exposed as document counts and explicit gaps. Historical replays are labeled separately from contemporaneous captures.", - "properties": { - "entries": { - "description": "One entry per completed run, oldest first. Absent entries mark gaps explicitly; no interpolation or silent zero filling.", - "items": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "basis": { - "description": "completion_capture pins the visible generation in the finalization transaction; retained_generation_replay derives a past point from the greatest retained generation activated by completed_at, not from current active rows.", - "enum": [ - "completion_capture", - "retained_generation_replay" - ], - "type": "string" - }, - "clerk_published_documents": { - "description": "Distinct type-P DocIDs across this completed run's twelve annual Clerk indexes, verified equal to the summed annual counts.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "completed_at": { - "description": "The run's first succeeded finalization event timestamp; the series is ordered by this instant, then run_id.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "computed_at": { - "description": "Actual instant the private ledger point was computed, including today's instant for a historical replay; never backdated to completion.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "documents_held": { - "description": "Sum of that run's immutable annual held-document counts, not today's acquisition count.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "documents_served": { - "description": "Distinct indexed House DocIDs whose row-version interval contains snapshot_generation; repeated rows for one document count once.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "held_rate": { - "description": "documents_held / clerk_published_documents, to twelve fractional places; the integer counts are authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Three distinct ratios: held/published, served/published and served/held. Each references counts in this same entry.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_of_held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "served_of_held_rate" - ], - "type": "object" - }, - "reason": { - "description": "Null because all counts were derived; absent entries carry an explanation instead.", - "type": "null" - }, - "run_id": { - "description": "Completed twelve-year reconciliation run identified by its immutable finalization event.", - "format": "uuid", - "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", - "type": "string" - }, - "served_of_held_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "documents_served / documents_held, to twelve fractional places; null when no documents were held." - }, - "served_rate": { - "description": "documents_served / clerk_published_documents, to twelve fractional places; the integer counts are authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "snapshot_generation": { - "description": "Retained temporal generation used for the served-document intersection. Later generations do not change this point.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "state": { - "const": "measured", - "description": "All three counts were derived and stored together; not a partial historical estimate.", - "type": "string" - } - }, - "required": [ - "run_id", - "completed_at", - "rate_basis", - "state", - "computed_at", - "snapshot_generation", - "basis", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "served_of_held_rate", - "reason" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "basis": { - "description": "No measurement or replay basis was established.", - "type": "null" - }, - "clerk_published_documents": { - "description": "Withheld with the other stages rather than presenting a partial funnel.", - "type": "null" - }, - "completed_at": { - "description": "The run's first succeeded finalization event timestamp; the series is ordered by this instant, then run_id.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "computed_at": { - "description": "No computation instant is invented for an absent point.", - "type": "null" - }, - "documents_held": { - "description": "Withheld with the other stages rather than presenting a partial funnel.", - "type": "null" - }, - "documents_served": { - "description": "Not derivable; current active versions are never substituted for past served counts.", - "type": "null" - }, - "held_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Three distinct ratios: held/published, served/published and served/held. Each references counts in this same entry.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_of_held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "served_of_held_rate" - ], - "type": "object" - }, - "reason": { - "description": "Why the completed run has no complete, derivable ledger point.", - "minLength": 1, - "type": "string" - }, - "run_id": { - "description": "Completed twelve-year reconciliation run identified by its immutable finalization event.", - "format": "uuid", - "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", - "type": "string" - }, - "served_of_held_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "served_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "snapshot_generation": { - "description": "No retained serving generation was established for this point.", - "type": "null" - }, - "state": { - "const": "absent", - "description": "The run completed, but no complete point is derivable or recorded; never plotted as zero.", - "type": "string" - } - }, - "required": [ - "run_id", - "completed_at", - "rate_basis", - "state", - "computed_at", - "snapshot_generation", - "basis", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "served_of_held_rate", - "reason" - ], - "type": "object" - } - ] - }, - "type": "array" - }, - "reason": { - "anyOf": [ - { - "minLength": 1, - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Series-level read or validation refusal; null for a successful read, even if some historical entries are absent." - }, - "state": { - "description": "Whether the series reader succeeded, not whether the live funnel is fresh or every historical run has a point.", - "enum": [ - "measured", - "unavailable" - ], - "type": "string" - } - }, - "required": [ - "state", - "entries", - "reason" - ], - "type": "object" - }, - "served_measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Database statement instant for the active-version count. measured_at separately records when the held/index reconciliation completed; these instants are not interchangeable." - }, - "served_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "source_year_end": { - "const": 2026, - "description": "Last configured Clerk archive year included in this complete-run measurement.", - "type": "number" - }, - "source_year_start": { - "const": 2015, - "description": "First configured Clerk archive year included in this complete-run measurement.", - "type": "number" - }, - "source_years": { - "const": 12, - "description": "Configured number of required archive years, source_year_end minus source_year_start plus one; all must reconcile before counts publish.", - "type": "number" - }, - "state": { - "const": "measured", - "type": "string" - }, - "years": { - "items": { - "additionalProperties": false, - "properties": { - "clerk_published_documents": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "detail": { - "type": "null" - }, - "documents_held": { - "description": "Indexed PTR DocIDs matched to held documents in this archive year and run, regardless of whether any transaction row is served.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "documents_missing": { - "description": "clerk_published_documents minus documents_held in this archive year and run, reconciled to the missing-reason document counts.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "documents_served": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "missing_by_classification": { - "additionalProperties": false, - "properties": { - "attempted_failed": { - "description": "Missing indexed PTR DocIDs with recorded retrieval attempts and no held match in the selected reconciliation year. Document count; no superseded-row filter applies.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "never_attempted": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "present_under_different_identifier": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - } - }, - "required": [ - "never_attempted", - "attempted_failed", - "present_under_different_identifier" - ], - "type": "object" - }, - "rate": { - "description": "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.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "rate_basis": { - "additionalProperties": false, - "description": "The legacy rate is a held-rate alias, not a served rate; every divisor and dividend is named here.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "rate" - ], - "type": "object" - }, - "rows_examined": { - "description": "Indexed PTR DocIDs examined for this archive year in the selected completed run; asserted equal to clerk_published_documents, not parsed transaction rows.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "served_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "state": { - "const": "measured", - "type": "string" - }, - "year": { - "description": "Annual Clerk archive year selected in the completed reconciliation, not the transaction year or filing-date bucket.", - "maximum": 2026, - "minimum": 2015, - "type": "integer" - } - }, - "required": [ - "year", - "state", - "rows_examined", - "clerk_published_documents", - "documents_held", - "documents_missing", - "documents_served", - "held_rate", - "served_rate", - "rate_basis", - "rate", - "missing_by_classification", - "detail" - ], - "type": "object" - }, - "maxItems": 12, - "minItems": 12, - "type": "array" - } - }, - "required": [ - "series", - "run_id", - "served_measured_at", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "rate_basis", - "state", - "measured_at", - "age_seconds", - "expected_max_age_seconds", - "rows_examined", - "source_year_start", - "source_year_end", - "source_years", - "measurement_definition", - "missing_document_ids_retained", - "years", - "detail" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "age_seconds": { - "type": "null" - }, - "clerk_published_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "detail": { - "minLength": 1, - "type": "string" - }, - "documents_held": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "expected_max_age_seconds": { - "const": 172800, - "description": "Configured maximum reconciliation age in seconds, even when no eligible measurement is available.", - "type": "number" - }, - "held_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "measured_at": { - "type": "null" - }, - "measurement_definition": { - "minLength": 1, - "type": "string" - }, - "missing_document_ids_retained": { - "type": "null" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Both rates divide their named document count by the published count in this object; ratios are 0 to 1, not percentages.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate" - ], - "type": "object" - }, - "rows_examined": { - "const": 0, - "description": "No complete verified reconciliation examination; sentinel zero is not a measured empty index. Funnel counts and rates are null.", - "type": "number" - }, - "run_id": { - "anyOf": [ - { - "minLength": 1, - "type": "string" - }, - { - "type": "null" - } - ], - "description": "The completed reconciliation selected by the shared funnel RPC; every archive-year count uses this run, never a union of runs." - }, - "series": { - "additionalProperties": false, - "description": "Private append-only reconciliation-run history exposed as document counts and explicit gaps. Historical replays are labeled separately from contemporaneous captures.", - "properties": { - "entries": { - "description": "One entry per completed run, oldest first. Absent entries mark gaps explicitly; no interpolation or silent zero filling.", - "items": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "basis": { - "description": "completion_capture pins the visible generation in the finalization transaction; retained_generation_replay derives a past point from the greatest retained generation activated by completed_at, not from current active rows.", - "enum": [ - "completion_capture", - "retained_generation_replay" - ], - "type": "string" - }, - "clerk_published_documents": { - "description": "Distinct type-P DocIDs across this completed run's twelve annual Clerk indexes, verified equal to the summed annual counts.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "completed_at": { - "description": "The run's first succeeded finalization event timestamp; the series is ordered by this instant, then run_id.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "computed_at": { - "description": "Actual instant the private ledger point was computed, including today's instant for a historical replay; never backdated to completion.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "documents_held": { - "description": "Sum of that run's immutable annual held-document counts, not today's acquisition count.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "documents_served": { - "description": "Distinct indexed House DocIDs whose row-version interval contains snapshot_generation; repeated rows for one document count once.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "held_rate": { - "description": "documents_held / clerk_published_documents, to twelve fractional places; the integer counts are authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Three distinct ratios: held/published, served/published and served/held. Each references counts in this same entry.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_of_held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "served_of_held_rate" - ], - "type": "object" - }, - "reason": { - "description": "Null because all counts were derived; absent entries carry an explanation instead.", - "type": "null" - }, - "run_id": { - "description": "Completed twelve-year reconciliation run identified by its immutable finalization event.", - "format": "uuid", - "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", - "type": "string" - }, - "served_of_held_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "documents_served / documents_held, to twelve fractional places; null when no documents were held." - }, - "served_rate": { - "description": "documents_served / clerk_published_documents, to twelve fractional places; the integer counts are authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "snapshot_generation": { - "description": "Retained temporal generation used for the served-document intersection. Later generations do not change this point.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "state": { - "const": "measured", - "description": "All three counts were derived and stored together; not a partial historical estimate.", - "type": "string" - } - }, - "required": [ - "run_id", - "completed_at", - "rate_basis", - "state", - "computed_at", - "snapshot_generation", - "basis", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "served_of_held_rate", - "reason" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "basis": { - "description": "No measurement or replay basis was established.", - "type": "null" - }, - "clerk_published_documents": { - "description": "Withheld with the other stages rather than presenting a partial funnel.", - "type": "null" - }, - "completed_at": { - "description": "The run's first succeeded finalization event timestamp; the series is ordered by this instant, then run_id.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{6}(?:Z))$", - "type": "string" - }, - "computed_at": { - "description": "No computation instant is invented for an absent point.", - "type": "null" - }, - "documents_held": { - "description": "Withheld with the other stages rather than presenting a partial funnel.", - "type": "null" - }, - "documents_served": { - "description": "Not derivable; current active versions are never substituted for past served counts.", - "type": "null" - }, - "held_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Three distinct ratios: held/published, served/published and served/held. Each references counts in this same entry.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_of_held_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "documents_held", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Division rule for this series entry, not a different run or the current corpus.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling integer document count used as divisor; zero withholds the rate.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling integer document count used as dividend.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "served_of_held_rate" - ], - "type": "object" - }, - "reason": { - "description": "Why the completed run has no complete, derivable ledger point.", - "minLength": 1, - "type": "string" - }, - "run_id": { - "description": "Completed twelve-year reconciliation run identified by its immutable finalization event.", - "format": "uuid", - "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", - "type": "string" - }, - "served_of_held_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "served_rate": { - "description": "No rate is emitted for an absent point.", - "type": "null" - }, - "snapshot_generation": { - "description": "No retained serving generation was established for this point.", - "type": "null" - }, - "state": { - "const": "absent", - "description": "The run completed, but no complete point is derivable or recorded; never plotted as zero.", - "type": "string" - } - }, - "required": [ - "run_id", - "completed_at", - "rate_basis", - "state", - "computed_at", - "snapshot_generation", - "basis", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "served_of_held_rate", - "reason" - ], - "type": "object" - } - ] - }, - "type": "array" - }, - "reason": { - "anyOf": [ - { - "minLength": 1, - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Series-level read or validation refusal; null for a successful read, even if some historical entries are absent." - }, - "state": { - "description": "Whether the series reader succeeded, not whether the live funnel is fresh or every historical run has a point.", - "enum": [ - "measured", - "unavailable" - ], - "type": "string" - } - }, - "required": [ - "state", - "entries", - "reason" - ], - "type": "object" - }, - "served_measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Database statement instant for the active-version count. measured_at separately records when the held/index reconciliation completed; these instants are not interchangeable." - }, - "served_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "source_year_end": { - "const": 2026, - "description": "Last configured archive year required for a complete reconciliation, not proof that its index was fetched.", - "type": "number" - }, - "source_year_start": { - "const": 2015, - "description": "First configured archive year required for a complete reconciliation, not proof that its index was fetched.", - "type": "number" - }, - "source_years": { - "const": 12, - "description": "Configured required archive-year count, source_year_end minus source_year_start plus one; not successfully measured years.", - "type": "number" - }, - "state": { - "const": "unevaluated", - "type": "string" - }, - "years": { - "items": { - "additionalProperties": false, - "properties": { - "clerk_published_documents": { - "type": "null" - }, - "detail": { - "minLength": 1, - "type": "string" - }, - "documents_held": { - "type": "null" - }, - "documents_missing": { - "type": "null" - }, - "documents_served": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "missing_by_classification": { - "type": "null" - }, - "rate": { - "type": "null" - }, - "rate_basis": { - "additionalProperties": false, - "description": "The legacy rate is a held-rate alias, not a served rate; every divisor and dividend is named here.", - "properties": { - "held_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_held", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - }, - "served_rate": { - "additionalProperties": false, - "description": "Machine-readable division rule; both referenced fields occur in this same coverage object.", - "properties": { - "denominator": { - "const": "clerk_published_documents", - "description": "Name of the sibling Clerk-index document count used as the denominator, never the held count.", - "type": "string" - }, - "numerator": { - "const": "documents_served", - "description": "Name of the sibling document count divided to produce this rate.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "held_rate", - "served_rate", - "rate" - ], - "type": "object" - }, - "rows_examined": { - "const": 0, - "description": "No verified document examination for this archive year; sentinel zero is not a measured empty index. Document counts are null.", - "type": "number" - }, - "served_rate": { - "anyOf": [ - { - "maximum": 1, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "state": { - "const": "unevaluated", - "type": "string" - }, - "year": { - "description": "Configured Clerk archive year awaiting measurement, not an observed transaction or filing year.", - "maximum": 2026, - "minimum": 2015, - "type": "integer" - } - }, - "required": [ - "year", - "state", - "rows_examined", - "clerk_published_documents", - "documents_held", - "documents_missing", - "documents_served", - "held_rate", - "served_rate", - "rate_basis", - "rate", - "missing_by_classification", - "detail" - ], - "type": "object" - }, - "maxItems": 12, - "minItems": 12, - "type": "array" - } - }, - "required": [ - "series", - "run_id", - "served_measured_at", - "clerk_published_documents", - "documents_held", - "documents_served", - "held_rate", - "served_rate", - "rate_basis", - "state", - "measured_at", - "age_seconds", - "expected_max_age_seconds", - "rows_examined", - "source_year_start", - "source_year_end", - "source_years", - "measurement_definition", - "missing_document_ids_retained", - "years", - "detail" - ], - "type": "object" - } - ], - "description": "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." - }, - "notice": { - "minLength": 1, - "type": "string" - }, - "paper_transcriptions": { - "additionalProperties": false, - "description": "Retained House paper PTR population, outstanding queue records, per-member projections and explicit reconciliation gaps. Transaction counts remain unknown before transcription.", - "properties": { - "archive_year": { - "description": "Clerk annual filing-index year being reconciled.", - "maximum": 9007199254740991, - "minimum": -9007199254740991, - "type": "integer" - }, - "by_member": { - "description": "Per-member projections of this same queue measurement, without additional database reads.", - "items": { - "additionalProperties": false, - "description": "Member projection of the shared House paper coverage measurement.", - "properties": { - "known_pending_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Observed outstanding queue records for this member, including unreconciled records; null when coverage is unavailable, and never a count of the uninspected population." - }, - "measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Timestamp inherited from the same coverage/counts RPC, canonical UTC Z; null when the read could not complete." - }, - "member_id": { - "description": "Canonical member identifier requested by the member surface.", - "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", - "type": "string" - }, - "paper_rows_reason": { - "const": "not_transcribed", - "description": "Why the member's remaining transaction-row count is unavailable.", - "type": "string" - }, - "paper_rows_remaining": { - "description": "Unknown transaction rows remaining for this member; never estimated.", - "type": "null" - }, - "pending": { - "description": "Observed pending and terminal paper-queue filings for this member, including records whose index reconciliation is incomplete.", - "items": { - "additionalProperties": false, - "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", - "properties": { - "active_followers": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." - }, - "doc_id": { - "description": "House Clerk PTR document identifier.", - "pattern": "^\\d+$", - "type": "string" - }, - "filing_date": { - "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - "type": "string" - }, - "member": { - "description": "Member name from retained Clerk filing metadata.", - "minLength": 1, - "type": "string" - }, - "member_id": { - "description": "Member route identifier, resolved through the existing member alias registry when available.", - "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", - "type": "string" - }, - "paper_rows": { - "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", - "type": "null" - }, - "paper_rows_reason": { - "const": "not_transcribed", - "description": "Why no transaction-row count is available.", - "type": "string" - }, - "queue_status": { - "description": "Outstanding transcription work or a retained terminal transcription failure.", - "enum": [ - "pending_transcription", - "failed_terminal" - ], - "type": "string" - }, - "reason": { - "description": "Named terminal queue diagnosis, or null when none is recorded.", - "type": [ - "string", - "null" - ] - }, - "receipt_url": { - "description": "Official Clerk PDF URL matching this DocID.", - "type": "string" - }, - "since": { - "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "since_basis": { - "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", - "enum": [ - "first_verified_no_text_inspection", - "first_terminal_document_outcome" - ], - "type": "string" - }, - "state": { - "const": "pending_transcription", - "description": "The filing has no completed verified transcription recorded in this queue.", - "type": "string" - } - }, - "required": [ - "doc_id", - "member", - "member_id", - "filing_date", - "receipt_url", - "state", - "queue_status", - "since", - "since_basis", - "reason", - "paper_rows", - "paper_rows_reason", - "active_followers" - ], - "type": "object" - }, - "type": "array" - }, - "pending_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Member's total outstanding queue filings only when the full annual population is measured; otherwise null." - }, - "pending_documents_reason": { - "description": "Reason the member total is unknown, inherited from the same coverage measurement.", - "type": [ - "string", - "null" - ] - }, - "state": { - "anyOf": [ - { - "const": "pending_transcription", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Pending transcription when at least one observed outstanding queue document exists; otherwise null, not a completeness claim." - } - }, - "required": [ - "member_id", - "measured_at", - "state", - "pending_documents", - "known_pending_documents", - "pending_documents_reason", - "paper_rows_remaining", - "paper_rows_reason", - "pending" - ], - "type": "object" - }, - "type": "array" - }, - "diagnostics": { - "additionalProperties": false, - "description": "Explicit reconciliation gaps. Missing evidence never becomes a zero count.", - "properties": { - "invalid_index_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Retained PTR manifest rows rejected for missing or conflicting receipt/date/member metadata; null when not examined." - }, - "queue_documents_outside_index": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Observed paper-queue documents absent from the retained annual index; null when not examined." - }, - "queue_metadata_mismatches": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Queue inspections whose receipt or filing date conflicts with the retained index; null when not examined." - } - }, - "required": [ - "invalid_index_rows", - "queue_metadata_mismatches", - "queue_documents_outside_index" - ], - "type": "object" - }, - "index_fetched_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Retained annual index fetch time, canonical UTC Z; not the queue measurement time." - }, - "index_ptr_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Distinct PTR documents in the reconciled annual index; null without a complete retained denominator." - }, - "index_receipt": { - "description": "Official Clerk annual ZIP URL supporting the index denominator, or null when unavailable.", - "type": [ - "string", - "null" - ] - }, - "index_run_id": { - "anyOf": [ - { - "format": "uuid", - "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Latest completed retained Clerk-index run used for every denominator, or null when unavailable." - }, - "inspected_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Indexed documents with a matching successful all-pages inspection; null when the index cannot be reconciled." - }, - "measured_at": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ], - "description": "Database transaction timestamp from the same RPC statement as these counts, canonical UTC Z; null when the read could not complete." - }, - "paper_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Total indexed no-text documents, including transcribed papers; null until every index document is inspected and queue metadata reconciles." - }, - "paper_rows_reason": { - "description": "Reason a remaining transaction-row count is unavailable.", - "type": "string" - }, - "paper_rows_remaining": { - "description": "Unmeasured transaction rows remaining in paper filings. Never inferred from page counts.", - "type": "null" - }, - "pending": { - "description": "Index-reconciled filings awaiting verified transcription ranked by active consented follows, then filing date and DocID.", - "items": { - "additionalProperties": false, - "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", - "properties": { - "active_followers": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." - }, - "doc_id": { - "description": "House Clerk PTR document identifier.", - "pattern": "^\\d+$", - "type": "string" - }, - "filing_date": { - "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - "type": "string" - }, - "member": { - "description": "Member name from retained Clerk filing metadata.", - "minLength": 1, - "type": "string" - }, - "member_id": { - "description": "Member route identifier, resolved through the existing member alias registry when available.", - "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", - "type": "string" - }, - "paper_rows": { - "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", - "type": "null" - }, - "paper_rows_reason": { - "const": "not_transcribed", - "description": "Why no transaction-row count is available.", - "type": "string" - }, - "queue_status": { - "description": "Outstanding transcription work or a retained terminal transcription failure.", - "enum": [ - "pending_transcription", - "failed_terminal" - ], - "type": "string" - }, - "reason": { - "description": "Named terminal queue diagnosis, or null when none is recorded.", - "type": [ - "string", - "null" - ] - }, - "receipt_url": { - "description": "Official Clerk PDF URL matching this DocID.", - "type": "string" - }, - "since": { - "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "since_basis": { - "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", - "enum": [ - "first_verified_no_text_inspection", - "first_terminal_document_outcome" - ], - "type": "string" - }, - "state": { - "const": "pending_transcription", - "description": "The filing has no completed verified transcription recorded in this queue.", - "type": "string" - } - }, - "required": [ - "doc_id", - "member", - "member_id", - "filing_date", - "receipt_url", - "state", - "queue_status", - "since", - "since_basis", - "reason", - "paper_rows", - "paper_rows_reason", - "active_followers" - ], - "type": "object" - }, - "type": "array" - }, - "pending_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Total indexed PTRs awaiting verified transcription, including paper and deterministic parser outcomes; null when the inspection population is incomplete." - }, - "reason": { - "description": "Named reason for incomplete or unavailable measurement; null only when reconciled.", - "type": [ - "string", - "null" - ] - }, - "state": { - "description": "Whether the retained annual index and complete PDF inspection population reconcile, remain incomplete, or cannot be read.", - "enum": [ - "measured", - "incomplete", - "unavailable" - ], - "type": "string" - }, - "terminal_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Observed terminal transcription failures matched to the retained index; null when the index cannot be reconciled." - }, - "transcribed_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Indexed queue documents explicitly completed after a matching verified parse committed; null when the index cannot be reconciled." - }, - "uninspected_documents": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Indexed documents lacking matching successful text-layer evidence; null when the index cannot be reconciled." - }, - "unreconciled": { - "description": "Outstanding queue records lacking matching current index evidence, retained visibly outside the reconciled denominator.", - "items": { - "additionalProperties": false, - "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", - "properties": { - "active_followers": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." - }, - "doc_id": { - "description": "House Clerk PTR document identifier.", - "pattern": "^\\d+$", - "type": "string" - }, - "filing_date": { - "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - "type": "string" - }, - "member": { - "description": "Member name from retained Clerk filing metadata.", - "minLength": 1, - "type": "string" - }, - "member_id": { - "description": "Member route identifier, resolved through the existing member alias registry when available.", - "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", - "type": "string" - }, - "paper_rows": { - "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", - "type": "null" - }, - "paper_rows_reason": { - "const": "not_transcribed", - "description": "Why no transaction-row count is available.", - "type": "string" - }, - "queue_status": { - "description": "Outstanding transcription work or a retained terminal transcription failure.", - "enum": [ - "pending_transcription", - "failed_terminal" - ], - "type": "string" - }, - "reason": { - "description": "Named terminal queue diagnosis, or null when none is recorded.", - "type": [ - "string", - "null" - ] - }, - "receipt_url": { - "description": "Official Clerk PDF URL matching this DocID.", - "type": "string" - }, - "since": { - "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "since_basis": { - "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", - "enum": [ - "first_verified_no_text_inspection", - "first_terminal_document_outcome" - ], - "type": "string" - }, - "state": { - "const": "pending_transcription", - "description": "The filing has no completed verified transcription recorded in this queue.", - "type": "string" - } - }, - "required": [ - "doc_id", - "member", - "member_id", - "filing_date", - "receipt_url", - "state", - "queue_status", - "since", - "since_basis", - "reason", - "paper_rows", - "paper_rows_reason", - "active_followers" - ], - "type": "object" - }, - "type": "array" - } - }, - "required": [ - "state", - "reason", - "archive_year", - "measured_at", - "index_run_id", - "index_fetched_at", - "index_receipt", - "index_ptr_documents", - "inspected_documents", - "uninspected_documents", - "paper_documents", - "pending_documents", - "terminal_documents", - "transcribed_documents", - "paper_rows_remaining", - "paper_rows_reason", - "diagnostics", - "pending", - "unreconciled", - "by_member" - ], - "type": "object" - }, - "provenance": { - "additionalProperties": false, - "properties": { - "by_collection_channel": { - "additionalProperties": false, - "properties": { - "house_clerk_direct_ocr": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "licensed_bulk_feed": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "senate_efd_direct": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - } - }, - "required": [ - "house_clerk_direct_ocr", - "senate_efd_direct", - "licensed_bulk_feed" - ], - "type": "object" - }, - "by_receipt_office": { - "additionalProperties": false, - "properties": { - "us_house_clerk": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - } - }, - "required": [ - "us_house_clerk", - "us_senate_efd" - ], - "type": "object" - }, - "deprecated_fields": { - "items": { - "type": "string" - }, - "type": "array" - }, - "field_successors": { - "additionalProperties": false, - "properties": { - "third_party_rows": { - "const": "licensed_feed_rows_total", - "type": "string" - } - }, - "required": [ - "third_party_rows" - ], - "type": "object" - }, - "licensed_feed_rows_total": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "measured_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "self_collected_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "state": { - "enum": [ - "measured", - "unavailable" - ], - "type": "string" - }, - "third_party_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "deprecated": true, - "description": "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.", - "x-veridion-successor": "licensed_feed_rows_total" - }, - "total_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "unattributed_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - } - }, - "required": [ - "state", - "population_basis", - "total_rows", - "measured_at", - "by_collection_channel", - "self_collected_rows", - "licensed_feed_rows_total", - "third_party_rows", - "unattributed_rows", - "deprecated_fields", - "field_successors", - "by_receipt_office" - ], - "type": "object" - }, - "provenance_field_coverage": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "detail": { - "type": "null" - }, - "fields": { - "items": { - "additionalProperties": false, - "properties": { - "examined": { - "description": "All active serving versions for this source with valid_to unset. The rate denominator; separate from warehouse history including superseded rows.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "field": { - "const": "source_line_number", - "type": "string" - }, - "null_interpretation": { - "enum": [ - "gap", - "not_applicable" - ], - "type": "string" - }, - "populated": { - "description": "Active serving versions for this source with source_line_number non-null. Closed versions are excluded; counts a field, not a resolved receipt URL.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "rate": { - "description": "populated divided by examined. The integer denominator and numerator remain authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Names the counts behind each published field-coverage rate in this same object.", - "properties": { - "rate": { - "additionalProperties": false, - "description": "Machine-readable division rule for the sibling rate.", - "properties": { - "denominator": { - "const": "examined", - "description": "The examined sibling count supplies this rate's denominator.", - "type": "string" - }, - "numerator": { - "const": "populated", - "description": "The populated sibling count supplies this rate's numerator.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "rate" - ], - "type": "object" - }, - "reason": { - "minLength": 1, - "type": "string" - }, - "source_system": { - "enum": [ - "house_clerk", - "senate_efd" - ], - "type": "string" - } - }, - "required": [ - "source_system", - "field", - "populated", - "examined", - "rate", - "null_interpretation", - "rate_basis", - "reason" - ], - "type": "object" - }, - "maxItems": 2, - "minItems": 2, - "type": "array" - }, - "house_clerk_gap_classes": { - "items": { - "additionalProperties": false, - "properties": { - "affected_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "classification": { - "minLength": 1, - "type": "string" - }, - "reason": { - "enum": [ - "warehouse_fallback_without_line_provenance", - "parser_output_without_line_provenance" - ], - "type": "string" - } - }, - "required": [ - "reason", - "affected_rows", - "classification" - ], - "type": "object" - }, - "maxItems": 2, - "minItems": 2, - "type": "array" - }, - "house_clerk_gap_register": { - "items": { - "additionalProperties": false, - "properties": { - "affected_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "document_id": { - "minLength": 1, - "type": "string" - }, - "parser_versions": { - "items": { - "minLength": 1, - "type": "string" - }, - "minItems": 1, - "type": "array" - }, - "reason": { - "const": "parser_output_without_line_provenance", - "type": "string" - } - }, - "required": [ - "document_id", - "affected_rows", - "parser_versions", - "reason" - ], - "type": "object" - }, - "type": "array" - }, - "measured_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "rows_examined": { - "description": "Sum of the House and Senate active-version examined counts. OGE, SEC and closed temporal versions are excluded; not independent document count.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "state": { - "const": "measured", - "type": "string" - } - }, - "required": [ - "state", - "population_basis", - "measured_at", - "rows_examined", - "fields", - "house_clerk_gap_classes", - "house_clerk_gap_register", - "detail" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "detail": { - "minLength": 1, - "type": "string" - }, - "fields": { - "items": { - "additionalProperties": false, - "properties": { - "examined": { - "description": "All active serving versions for this source with valid_to unset. The rate denominator; separate from warehouse history including superseded rows.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "field": { - "const": "source_line_number", - "type": "string" - }, - "null_interpretation": { - "enum": [ - "gap", - "not_applicable" - ], - "type": "string" - }, - "populated": { - "description": "Active serving versions for this source with source_line_number non-null. Closed versions are excluded; counts a field, not a resolved receipt URL.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "rate": { - "description": "populated divided by examined. The integer denominator and numerator remain authoritative.", - "maximum": 1, - "minimum": 0, - "type": "number" - }, - "rate_basis": { - "additionalProperties": false, - "description": "Names the counts behind each published field-coverage rate in this same object.", - "properties": { - "rate": { - "additionalProperties": false, - "description": "Machine-readable division rule for the sibling rate.", - "properties": { - "denominator": { - "const": "examined", - "description": "The examined sibling count supplies this rate's denominator.", - "type": "string" - }, - "numerator": { - "const": "populated", - "description": "The populated sibling count supplies this rate's numerator.", - "type": "string" - } - }, - "required": [ - "numerator", - "denominator" - ], - "type": "object" - } - }, - "required": [ - "rate" - ], - "type": "object" - }, - "reason": { - "minLength": 1, - "type": "string" - }, - "source_system": { - "enum": [ - "house_clerk", - "senate_efd" - ], - "type": "string" - } - }, - "required": [ - "source_system", - "field", - "populated", - "examined", - "rate", - "null_interpretation", - "rate_basis", - "reason" - ], - "type": "object" - }, - "maxItems": 0, - "minItems": 0, - "type": "array" - }, - "house_clerk_gap_classes": { - "items": { - "additionalProperties": false, - "properties": { - "affected_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "classification": { - "minLength": 1, - "type": "string" - }, - "reason": { - "enum": [ - "warehouse_fallback_without_line_provenance", - "parser_output_without_line_provenance" - ], - "type": "string" - } - }, - "required": [ - "reason", - "affected_rows", - "classification" - ], - "type": "object" - }, - "maxItems": 0, - "minItems": 0, - "type": "array" - }, - "house_clerk_gap_register": { - "items": { - "additionalProperties": false, - "properties": { - "affected_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "document_id": { - "minLength": 1, - "type": "string" - }, - "parser_versions": { - "items": { - "minLength": 1, - "type": "string" - }, - "minItems": 1, - "type": "array" - }, - "reason": { - "const": "parser_output_without_line_provenance", - "type": "string" - } - }, - "required": [ - "document_id", - "affected_rows", - "parser_versions", - "reason" - ], - "type": "object" - }, - "maxItems": 0, - "minItems": 0, - "type": "array" - }, - "measured_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "rows_examined": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "state": { - "const": "unavailable", - "type": "string" - } - }, - "required": [ - "state", - "population_basis", - "measured_at", - "rows_examined", - "fields", - "house_clerk_gap_classes", - "house_clerk_gap_register", - "detail" - ], - "type": "object" - } - ] - }, - "provenance_reconciliation": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "detail": { - "type": "null" - }, - "licensed_feed_document_reference_rows": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "licensed_feed_rows_total": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "licensed_feed_rows_without_document_reference": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "licensed_feed_rows_without_document_reference_pct_of_licensed_feed": { - "anyOf": [ - { - "maximum": 100, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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": { - "anyOf": [ - { - "maximum": 100, - "minimum": 0, - "type": "number" - }, - { - "type": "null" - } - ], - "description": "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." - }, - "measurement_timestamps": { - "additionalProperties": false, - "properties": { - "collection_ownership": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "receipt_reference": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - } - }, - "required": [ - "receipt_reference", - "collection_ownership" - ], - "type": "object" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "reason": { - "minLength": 1, - "type": "string" - }, - "relationships": { - "items": { - "minLength": 1, - "type": "string" - }, - "minItems": 2, - "type": "array" - }, - "rows_examined": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 1, - "type": "integer" - }, - "state": { - "const": "reconciled", - "type": "string" - } - }, - "required": [ - "state", - "population_basis", - "rows_examined", - "measurement_timestamps", - "licensed_feed_rows_total", - "licensed_feed_document_reference_rows", - "licensed_feed_rows_without_document_reference", - "licensed_feed_rows_without_document_reference_pct_of_licensed_feed", - "licensed_feed_rows_without_document_reference_pct_of_warehouse", - "reason", - "relationships", - "detail" - ], - "type": "object" - }, - { - "additionalProperties": false, - "properties": { - "detail": { - "minLength": 1, - "type": "string" - }, - "measurement_timestamps": { - "additionalProperties": false, - "properties": { - "collection_ownership": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "receipt_reference": { - "anyOf": [ - { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "receipt_reference", - "collection_ownership" - ], - "type": "object" - }, - "population_basis": { - "description": "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.", - "minLength": 1, - "type": "string" - }, - "rows_examined": { - "description": "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.", - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - "state": { - "const": "unavailable", - "type": "string" - } - }, - "required": [ - "state", - "population_basis", - "rows_examined", - "measurement_timestamps", - "detail" - ], - "type": "object" - } - ] - }, - "request_access": { - "format": "uri", - "type": "string" - }, - "serving": { - "additionalProperties": false, - "description": "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.", - "properties": { - "basis": { - "minLength": 1, - "type": "string" - }, - "by_chamber": { - "additionalProperties": false, - "properties": { - "executive": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose chamber is executive; closed versions excluded, separate exact-count read, null if unavailable." - }, - "house": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose chamber is house; closed versions excluded, separate exact-count read, null if unavailable." - }, - "senate": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose chamber is senate; closed versions excluded, separate exact-count read, null if unavailable." - } - }, - "required": [ - "house", - "senate", - "executive" - ], - "type": "object" - }, - "by_source_system": { - "additionalProperties": false, - "properties": { - "house_clerk": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose source_system is house_clerk; closed versions excluded, separate exact-count read, null if unavailable." - }, - "oge": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose source_system is oge; closed versions excluded, separate exact-count read, null if unavailable." - }, - "senate_efd": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "Active serving versions whose source_system is senate_efd; closed versions excluded, separate exact-count read, null if unavailable." - } - }, - "required": [ - "house_clerk", - "senate_efd", - "oge" - ], - "type": "object" - }, - "measured_at": { - "format": "date-time", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", - "type": "string" - }, - "state": { - "enum": [ - "measured", - "unavailable" - ], - "type": "string" - }, - "total_rows": { - "anyOf": [ - { - "maximum": 9007199254740991, - "minimum": 0, - "type": "integer" - }, - { - "type": "null" - } - ], - "description": "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." - } - }, - "required": [ - "state", - "measured_at", - "basis", - "total_rows", - "by_source_system", - "by_chamber" - ], - "type": "object" - }, - "sources_of_record": { - "items": { - "additionalProperties": false, - "properties": { - "office": { - "minLength": 1, - "type": "string" - }, - "publishing": { - "description": "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.", - "type": "boolean" - }, - "url": { - "format": "uri", - "type": "string" - } - }, - "required": [ - "office", - "url", - "publishing" - ], - "type": "object" - }, - "type": "array" - }, - "version": { - "const": "v1-preview", - "type": "string" - } - }, - "required": [ - "paper_transcriptions", - "dataset", - "version", - "generated_at", - "cache", - "description", - "serving", - "congress", - "provenance", - "provenance_field_coverage", - "house_clerk_ptr_completeness", - "provenance_reconciliation", - "sources_of_record", - "exclusions", - "notice", - "request_access" - ], - "type": "object" -}New value: +null
Changed2 schema fields changed
- added
Output schema / properties / paper_transcriptionsAdded value: +{ + "additionalProperties": false, + "description": "Retained House paper PTR population, outstanding queue records, per-member projections and explicit reconciliation gaps. Transaction counts remain unknown before transcription.", + "properties": { + "archive_year": { + "description": "Clerk annual filing-index year being reconciled.", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "by_member": { + "description": "Per-member projections of this same queue measurement, without additional database reads.", + "items": { + "additionalProperties": false, + "description": "Member projection of the shared House paper coverage measurement.", + "properties": { + "known_pending_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Observed outstanding queue records for this member, including unreconciled records; null when coverage is unavailable, and never a count of the uninspected population." + }, + "measured_at": { + "anyOf": [ + { + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Timestamp inherited from the same coverage/counts RPC, canonical UTC Z; null when the read could not complete." + }, + "member_id": { + "description": "Canonical member identifier requested by the member surface.", + "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", + "type": "string" + }, + "paper_rows_reason": { + "const": "not_transcribed", + "description": "Why the member's remaining transaction-row count is unavailable.", + "type": "string" + }, + "paper_rows_remaining": { + "description": "Unknown transaction rows remaining for this member; never estimated.", + "type": "null" + }, + "pending": { + "description": "Observed pending and terminal paper-queue filings for this member, including records whose index reconciliation is incomplete.", + "items": { + "additionalProperties": false, + "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", + "properties": { + "active_followers": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." + }, + "doc_id": { + "description": "House Clerk PTR document identifier.", + "pattern": "^\\d+$", + "type": "string" + }, + "filing_date": { + "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "type": "string" + }, + "member": { + "description": "Member name from retained Clerk filing metadata.", + "minLength": 1, + "type": "string" + }, + "member_id": { + "description": "Member route identifier, resolved through the existing member alias registry when available.", + "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", + "type": "string" + }, + "paper_rows": { + "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", + "type": "null" + }, + "paper_rows_reason": { + "const": "not_transcribed", + "description": "Why no transaction-row count is available.", + "type": "string" + }, + "queue_status": { + "description": "Outstanding transcription work or a retained terminal transcription failure.", + "enum": [ + "pending_transcription", + "failed_terminal" + ], + "type": "string" + }, + "reason": { + "description": "Named terminal queue diagnosis, or null when none is recorded.", + "type": [ + "string", + "null" + ] + }, + "receipt_url": { + "description": "Official Clerk PDF URL matching this DocID.", + "type": "string" + }, + "since": { + "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + "since_basis": { + "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", + "enum": [ + "first_verified_no_text_inspection", + "first_terminal_document_outcome" + ], + "type": "string" + }, + "state": { + "const": "pending_transcription", + "description": "The filing has no completed verified transcription recorded in this queue.", + "type": "string" + } + }, + "required": [ + "doc_id", + "member", + "member_id", + "filing_date", + "receipt_url", + "state", + "queue_status", + "since", + "since_basis", + "reason", + "paper_rows", + "paper_rows_reason", + "active_followers" + ], + "type": "object" + }, + "type": "array" + }, + "pending_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Member's total outstanding queue filings only when the full annual population is measured; otherwise null." + }, + "pending_documents_reason": { + "description": "Reason the member total is unknown, inherited from the same coverage measurement.", + "type": [ + "string", + "null" + ] + }, + "state": { + "anyOf": [ + { + "const": "pending_transcription", + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Pending transcription when at least one observed outstanding queue document exists; otherwise null, not a completeness claim." + } + }, + "required": [ + "member_id", + "measured_at", + "state", + "pending_documents", + "known_pending_documents", + "pending_documents_reason", + "paper_rows_remaining", + "paper_rows_reason", + "pending" + ], + "type": "object" + }, + "type": "array" + }, + "diagnostics": { + "additionalProperties": false, + "description": "Explicit reconciliation gaps. Missing evidence never becomes a zero count.", + "properties": { + "invalid_index_rows": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Retained PTR manifest rows rejected for missing or conflicting receipt/date/member metadata; null when not examined." + }, + "queue_documents_outside_index": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Observed paper-queue documents absent from the retained annual index; null when not examined." + }, + "queue_metadata_mismatches": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Queue inspections whose receipt or filing date conflicts with the retained index; null when not examined." + } + }, + "required": [ + "invalid_index_rows", + "queue_metadata_mismatches", + "queue_documents_outside_index" + ], + "type": "object" + }, + "index_fetched_at": { + "anyOf": [ + { + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Retained annual index fetch time, canonical UTC Z; not the queue measurement time." + }, + "index_ptr_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Distinct PTR documents in the reconciled annual index; null without a complete retained denominator." + }, + "index_receipt": { + "description": "Official Clerk annual ZIP URL supporting the index denominator, or null when unavailable.", + "type": [ + "string", + "null" + ] + }, + "index_run_id": { + "anyOf": [ + { + "format": "uuid", + "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Latest completed retained Clerk-index run used for every denominator, or null when unavailable." + }, + "inspected_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Indexed documents with a matching successful all-pages inspection; null when the index cannot be reconciled." + }, + "measured_at": { + "anyOf": [ + { + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Database transaction timestamp from the same RPC statement as these counts, canonical UTC Z; null when the read could not complete." + }, + "paper_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Total indexed no-text documents, including transcribed papers; null until every index document is inspected and queue metadata reconciles." + }, + "paper_rows_reason": { + "description": "Reason a remaining transaction-row count is unavailable.", + "type": "string" + }, + "paper_rows_remaining": { + "description": "Unmeasured transaction rows remaining in paper filings. Never inferred from page counts.", + "type": "null" + }, + "pending": { + "description": "Index-reconciled filings awaiting verified transcription ranked by active consented follows, then filing date and DocID.", + "items": { + "additionalProperties": false, + "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", + "properties": { + "active_followers": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." + }, + "doc_id": { + "description": "House Clerk PTR document identifier.", + "pattern": "^\\d+$", + "type": "string" + }, + "filing_date": { + "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "type": "string" + }, + "member": { + "description": "Member name from retained Clerk filing metadata.", + "minLength": 1, + "type": "string" + }, + "member_id": { + "description": "Member route identifier, resolved through the existing member alias registry when available.", + "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", + "type": "string" + }, + "paper_rows": { + "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", + "type": "null" + }, + "paper_rows_reason": { + "const": "not_transcribed", + "description": "Why no transaction-row count is available.", + "type": "string" + }, + "queue_status": { + "description": "Outstanding transcription work or a retained terminal transcription failure.", + "enum": [ + "pending_transcription", + "failed_terminal" + ], + "type": "string" + }, + "reason": { + "description": "Named terminal queue diagnosis, or null when none is recorded.", + "type": [ + "string", + "null" + ] + }, + "receipt_url": { + "description": "Official Clerk PDF URL matching this DocID.", + "type": "string" + }, + "since": { + "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + "since_basis": { + "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", + "enum": [ + "first_verified_no_text_inspection", + "first_terminal_document_outcome" + ], + "type": "string" + }, + "state": { + "const": "pending_transcription", + "description": "The filing has no completed verified transcription recorded in this queue.", + "type": "string" + } + }, + "required": [ + "doc_id", + "member", + "member_id", + "filing_date", + "receipt_url", + "state", + "queue_status", + "since", + "since_basis", + "reason", + "paper_rows", + "paper_rows_reason", + "active_followers" + ], + "type": "object" + }, + "type": "array" + }, + "pending_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Total indexed PTRs awaiting verified transcription, including paper and deterministic parser outcomes; null when the inspection population is incomplete." + }, + "reason": { + "description": "Named reason for incomplete or unavailable measurement; null only when reconciled.", + "type": [ + "string", + "null" + ] + }, + "state": { + "description": "Whether the retained annual index and complete PDF inspection population reconcile, remain incomplete, or cannot be read.", + "enum": [ + "measured", + "incomplete", + "unavailable" + ], + "type": "string" + }, + "terminal_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Observed terminal transcription failures matched to the retained index; null when the index cannot be reconciled." + }, + "transcribed_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Indexed queue documents explicitly completed after a matching verified parse committed; null when the index cannot be reconciled." + }, + "uninspected_documents": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Indexed documents lacking matching successful text-layer evidence; null when the index cannot be reconciled." + }, + "unreconciled": { + "description": "Outstanding queue records lacking matching current index evidence, retained visibly outside the reconciled denominator.", + "items": { + "additionalProperties": false, + "description": "An outstanding PTR requiring verified transcription, with its official receipt, first terminal-outcome time and queue diagnosis. Parser failures do not attest paper.", + "properties": { + "active_followers": { + "anyOf": [ + { + "maximum": 9007199254740991, + "minimum": 0, + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "Distinct active consented member subscribers across paid preferences and confirmed free follows; aggregate only, or null when not measured." + }, + "doc_id": { + "description": "House Clerk PTR document identifier.", + "pattern": "^\\d+$", + "type": "string" + }, + "filing_date": { + "description": "Filing date printed in the retained Clerk annual index, YYYY-MM-DD.", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "type": "string" + }, + "member": { + "description": "Member name from retained Clerk filing metadata.", + "minLength": 1, + "type": "string" + }, + "member_id": { + "description": "Member route identifier, resolved through the existing member alias registry when available.", + "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", + "type": "string" + }, + "paper_rows": { + "description": "Unknown transaction-row count. PDF page counts and external trade counts are not substitutes.", + "type": "null" + }, + "paper_rows_reason": { + "const": "not_transcribed", + "description": "Why no transaction-row count is available.", + "type": "string" + }, + "queue_status": { + "description": "Outstanding transcription work or a retained terminal transcription failure.", + "enum": [ + "pending_transcription", + "failed_terminal" + ], + "type": "string" + }, + "reason": { + "description": "Named terminal queue diagnosis, or null when none is recorded.", + "type": [ + "string", + "null" + ] + }, + "receipt_url": { + "description": "Official Clerk PDF URL matching this DocID.", + "type": "string" + }, + "since": { + "description": "First instrumented terminal document outcome, canonical UTC Z. This does not measure filing discovery delay.", + "format": "date-time", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", + "type": "string" + }, + "since_basis": { + "description": "Evidence defining the since timestamp; it is never backdated to the filing date. Parser failures do not attest absence of text.", + "enum": [ + "first_verified_no_text_inspection", + "first_terminal_document_outcome" + ], + "type": "string" + }, + "state": { + "const": "pending_transcription", + "description": "The filing has no completed verified transcription recorded in this queue.", + "type": "string" + } + }, + "required": [ + "doc_id", + "member", + "member_id", + "filing_date", + "receipt_url", + "state", + "queue_status", + "since", + "since_basis", + "reason", + "paper_rows", + "paper_rows_reason", + "active_followers" + ], + "type": "object" + }, + "type": "array" + } + }, + "required": [ + "state", + "reason", + "archive_year", + "measured_at", + "index_run_id", + "index_fetched_at", + "index_receipt", + "index_ptr_documents", + "inspected_documents", + "uninspected_documents", + "paper_documents", + "pending_documents", + "terminal_documents", + "transcribed_documents", + "paper_rows_remaining", + "paper_rows_reason", + "diagnostics", + "pending", + "unreconciled", + "by_member" + ], + "type": "object" +} - changed
Output schema / requiredPrevious value: -[ - "dataset", - "version", - "generated_at", - "cache", - "description", - "serving", - "congress", - "provenance", - "provenance_field_coverage", - "house_clerk_ptr_completeness", - "provenance_reconciliation", - "sources_of_record", - "exclusions", - "notice", - "request_access" -]New value: +[ + "paper_transcriptions", + "dataset", + "version", + "generated_at", + "cache", + "description", + "serving", + "congress", + "provenance", + "provenance_field_coverage", + "house_clerk_ptr_completeness", + "provenance_reconciliation", + "sources_of_record", + "exclusions", + "notice", + "request_access" +]
- First observed
TDQS
A3.5/5.0
Behavior3/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint=false and destructiveHint=false, so the safety profile is covered structurally. The description adds real value by disclosing that counts are measured from the serving views at request time, i.e. live rather than cached, but says nothing about cost, rate limits, or freshness guarantees.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence, front-loaded with what is returned and followed by the freshness qualifier. No filler and nothing an agent must read twice.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter, read-only tool with no output schema, the description adequately covers what comes back (rows, filers, per-source totals) and when it is measured. Only the precise shape and any pagination or size caveats are left unspecified, which is a minor gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so there is no parameter semantics to explain — the baseline for a no-arg tool applies. The description instead spends its words on the return aggregates, which is the right allocation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a concrete resource (coverage counts) and enumerates the specific aggregates returned (rows, filers, per-source totals), so an agent knows exactly what it gets. It does not, however, differentiate itself from the sibling get_status, which an agent could plausibly confuse with a coverage/health read.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines2/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no explicit when-to-use guidance, no conditions or prerequisites, and no mention of alternative tools such as get_status or search_disclosures. Usage is only inferable from the topic of the resource.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd
Glama MCP Gateway
Add one secure layer between your agents and this server.