changedOutput schema / (root)
Previous value: -{
- "additionalProperties": false,
- "properties": {
- "billing_gate": {
- "additionalProperties": false,
- "description": "A completed UTC day qualifies only when all 24 distinct hourly observations are present and operational. Operational means the public status evaluator returned ready with no degraded reasons. Missing hours break the streak; today's incomplete hour is not missing until it ends. A recorded non-operational sample today resets the streak immediately. Missing completed hours are recorded as observation_missing failures, with no invented observation timestamp. No operational history is backfilled. Hourly samples do not establish continuous availability or a service-level guarantee.",
- "properties": {
- "consecutive_operational_days": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Completed qualifying UTC days since the latest failed or missing hourly sample. Null means unavailable, not zero."
- },
- "counting_since": {
- "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": "First stored observation instant. No history is inferred from deployment or backfilled; null when none exists or unreadable."
- },
- "definition": {
- "const": "A completed UTC day qualifies only when all 24 distinct hourly observations are present and operational. Operational means the public status evaluator returned ready with no degraded reasons. Missing hours break the streak; today's incomplete hour is not missing until it ends. A recorded non-operational sample today resets the streak immediately. Missing completed hours are recorded as observation_missing failures, with no invented observation timestamp. No operational history is backfilled. Hourly samples do not establish continuous availability or a service-level guarantee.",
- "description": "Pre-registered day, gap and incomplete-day rules used by the stored counter.",
- "type": "string"
- },
- "detail": {
- "description": "Why no observations or no measurement are available; otherwise null.",
- "type": [
- "string",
- "null"
- ]
- },
- "last_non_operational_day": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "Latest UTC date with a failed sample or missing completed hour since collection began. Null if none exists or unreadable."
- },
- "measured_at": {
- "description": "Database computation instant, or the instant the read was declared unavailable. Not a deployment date.",
- "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"
- },
- "reasons_on_last_non_operational_day": {
- "description": "Distinct failure codes for the last non-operational day. observation_missing is a persisted closed-hour gap; missing_hour is an absent hour not yet recorded. Both break the streak.",
- "items": {
- "minLength": 1,
- "type": "string"
- },
- "type": "array"
- },
- "required_days": {
- "const": 14,
- "description": "Required consecutive completed operational UTC days.",
- "type": "number"
- },
- "state": {
- "description": "Stored samples qualify the streak, are still accruing, or could not be read. This item does not activate checkout.",
- "enum": [
- "accruing",
- "eligible",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "required_days",
- "consecutive_operational_days",
- "counting_since",
- "last_non_operational_day",
- "reasons_on_last_non_operational_day",
- "measured_at",
- "definition",
- "detail"
- ],
- "type": "object"
- },
- "bulk_export": {
- "additionalProperties": false,
- "description": "The daily bulk snapshot: its day, generation, size, file hash and Merkle commitment. Absent only on the unavailable body.",
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus the snapshot's generated_at, in whole seconds."
- },
- "byte_size": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Size in bytes of the stored snapshot file, as verified after writing."
- },
- "content_hash_basis": {
- "description": "The content_hash basis the leaves were hashed under (veridion-disclosure-content-v1). Set exactly when merkle_root is set.",
- "type": [
- "string",
- "null"
- ]
- },
- "detail": {
- "description": "Why the export is not ready, when it is not; null when ready.",
- "type": [
- "string",
- "null"
- ]
- },
- "expected_max_age_seconds": {
- "description": "108000 (30 hours): the snapshot runs daily at 07:40 UTC, so one slow run passes and a fully missed day is flagged before a second day of silence.",
- "minimum": 0,
- "type": "number"
- },
- "generated_at": {
- "description": "When the newest snapshot finished writing and its manifest was recorded.",
- "type": [
- "string",
- "null"
- ]
- },
- "latest_snapshot_day": {
- "description": "The UTC day the newest snapshot was pinned to, the same day /v1/export names.",
- "type": [
- "string",
- "null"
- ]
- },
- "merkle_root": {
- "anyOf": [
- {
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Merkle root over every row's content_hash in the export: leaves in disclosure_id order, sha256 over the concatenated 32-byte child digests, an odd node paired with itself. Recomputed from the stored bytes before the manifest was written. Null for a snapshot generated before 1.3.6. scripts/verify-disclosure-export.mjs recomputes it from a downloaded export with no network and compares it with this value."
- },
- "row_count": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Rows in the snapshot file after validation; the leaves the merkle_root commits to."
- },
- "rows_dropped_failed_validation": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Rows the serving view returned that failed the contract schema and were left out of the file rather than written broken. Zero is the expected value; a positive count is published, never hidden."
- },
- "sha256": {
- "description": "sha256, hex, of the stored snapshot file. Verify a download against it before reading.",
- "type": [
- "string",
- "null"
- ]
- },
- "snapshot_generation": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "The temporal generation the snapshot was pinned to; the same value as_of reads and /v1/export report for that day."
- },
- "state": {
- "description": "ready: the latest daily snapshot manifest is readable and younger than expected_max_age_seconds. stale: older. unavailable: the manifest could not be read. no_snapshot_yet: none has been written.",
- "minLength": 1,
- "type": "string"
- },
- "threshold_basis": {
- "description": "An operational alerting threshold chosen by Veridion. Not a service commitment; commercial terms live in a license.",
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "state",
- "latest_snapshot_day",
- "generated_at",
- "snapshot_generation",
- "row_count",
- "rows_dropped_failed_validation",
- "byte_size",
- "sha256",
- "merkle_root",
- "content_hash_basis",
- "age_seconds",
- "expected_max_age_seconds",
- "threshold_basis",
- "detail"
- ],
- "type": "object"
- },
- "cache": {
- "additionalProperties": false,
- "description": "Always no-store with zero max-age at every layer: a status page that could be served stale would defeat itself. age_header is null because no cache is permitted to add one.",
- "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_public_summary": {
- "additionalProperties": false,
- "description": "The first-party Congress public-summary materialization, its age, and whether the newest owner outcome attests to it. Absent only on the unavailable body.",
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus refreshed_at, in whole seconds."
- },
- "detail": {
- "description": "Why the summary is not ready, when it is not; null when ready.",
- "type": [
- "string",
- "null"
- ]
- },
- "expected_max_age_seconds": {
- "description": "21600 (6 hours): the summary's independently scheduled owner runs every four hours.",
- "minimum": 0,
- "type": "number"
- },
- "refresh_outcome": {
- "additionalProperties": false,
- "description": "The newest outcome recorded by the summary's owner, which is what attests the served figures.",
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus observed_at, in whole seconds."
- },
- "amount_coverage_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds in the amount_coverage stage."
- },
- "attempt_id": {
- "description": "The owner attempt this outcome belongs to. Every refresh of the summary records one; a summary refreshed without one reads unattested.",
- "type": [
- "string",
- "null"
- ]
- },
- "detail": {
- "description": "The failure's own text; null on success.",
- "type": [
- "string",
- "null"
- ]
- },
- "disclosure_aggregates_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds in the disclosure_aggregates stage."
- },
- "error_code": {
- "description": "The stable code of the failure, when the attempt failed; null otherwise.",
- "type": [
- "string",
- "null"
- ]
- },
- "observed_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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "When the terminal event was recorded."
- },
- "public_summary_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds in the public_summary stage."
- },
- "rows_examined": {
- "description": "Warehouse rows the attempt examined; zero on a failure before the summary stage.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "stage": {
- "anyOf": [
- {
- "enum": [
- "preflight",
- "amount_coverage",
- "public_summary",
- "disclosure_aggregates",
- "verification",
- "complete"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "The stage the attempt reached, in order: preflight, amount_coverage, public_summary, disclosure_aggregates, verification, complete."
- },
- "started_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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "When the attempt started."
- },
- "state": {
- "description": "The newest recorded outcome of the summary's owner: succeeded or failed at a stage, running while an attempt is open, stalled when an open attempt has outlived its ceiling, unevaluated when none is recorded, unavailable when the ledger could not be read.",
- "enum": [
- "succeeded",
- "failed",
- "unevaluated",
- "running",
- "stalled",
- "unavailable"
- ],
- "type": "string"
- },
- "summary_refreshed_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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "The refreshed_at the attempt stamped on the summary. When this equals the block's refreshed_at, the served summary is attested by this outcome."
- },
- "total_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds for the whole attempt."
- },
- "warehouse_rows": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Warehouse rows at the time of the attempt, as the owner counted them."
- }
- },
- "required": [
- "state",
- "attempt_id",
- "stage",
- "started_at",
- "observed_at",
- "age_seconds",
- "rows_examined",
- "warehouse_rows",
- "summary_refreshed_at",
- "amount_coverage_duration_ms",
- "public_summary_duration_ms",
- "disclosure_aggregates_duration_ms",
- "total_duration_ms",
- "error_code",
- "detail"
- ],
- "type": "object"
- },
- "refreshed_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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "When the served Congress summary was last rewritten, in the warehouse's own timestamp form."
- },
- "state": {
- "description": "ready: the newest successful refresh outcome attests to the served summary. unattested: the summary's refreshed_at is newer than any recorded outcome, so the served figures were written by a path that did not record its outcome. stale/unavailable: age or read failure. The remaining values echo refresh_outcome.state when no better word applies; 'succeeded' is no longer emitted.",
- "enum": [
- "ready",
- "stale",
- "unavailable",
- "unattested",
- "succeeded",
- "failed",
- "unevaluated",
- "running",
- "stalled"
- ],
- "type": "string"
- },
- "threshold_basis": {
- "description": "An operational alerting threshold chosen by Veridion. Not a service commitment; commercial terms live in a license.",
- "minLength": 1,
- "type": "string"
- },
- "warehouse_rows": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Congressional warehouse rows the summary was computed over, including rows not yet qualified for the API."
- }
- },
- "required": [
- "state",
- "refreshed_at",
- "age_seconds",
- "expected_max_age_seconds",
- "threshold_basis",
- "warehouse_rows",
- "refresh_outcome",
- "detail"
- ],
- "type": "object"
- },
- "coverage_recovery": {
- "additionalProperties": false,
- "description": "Where House Clerk document recovery stands: how many documents are parsed, queued, failing, terminally failed, or withheld by the lossless-reparse check. Absent only on the unavailable body.",
- "properties": {
- "computed_at": {
- "description": "When the stamped coverage measurement was computed.",
- "type": [
- "string",
- "null"
- ]
- },
- "detail": {
- "description": "Why the block is stale or unavailable, when it is; null otherwise.",
- "type": [
- "string",
- "null"
- ]
- },
- "documents_total": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "House Clerk PTR documents known to the recovery ledger."
- },
- "failed": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents whose latest attempt failed and will be retried."
- },
- "failed_terminal": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents whose attempts are exhausted; no further retry is scheduled and no rows are served from them."
- },
- "in_progress": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents with an attempt under way."
- },
- "is_stale": {
- "description": "true when computed_at is older than the measurement's own stale_after budget.",
- "type": "boolean"
- },
- "parser_reparse_row_loss": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents where a reparse produced fewer rows than were served before and the lossless check rejected the replacement. Those documents are absent from the API rather than served with a lossy replacement."
- },
- "pending": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents queued for a parse or reparse and not yet attempted."
- },
- "refresh_outcome": {
- "additionalProperties": false,
- "description": "The latest recorded refresh of the coverage measurement, so a reader can tell a fresh number from a stale one.",
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus completed_at, in whole seconds."
- },
- "attempted_at": {
- "description": "When the latest refresh started.",
- "type": [
- "string",
- "null"
- ]
- },
- "completed_at": {
- "description": "When the latest refresh finished; null if it did not.",
- "type": [
- "string",
- "null"
- ]
- },
- "coverage_refresh_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds spent in the coverage_snapshot stage."
- },
- "detail": {
- "description": "The failure's own text, or why no outcome could be read; null on success.",
- "type": [
- "string",
- "null"
- ]
- },
- "error_code": {
- "description": "The stable code of the failure, when the refresh failed; null otherwise.",
- "type": [
- "string",
- "null"
- ]
- },
- "parser_state_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds spent in the parser_state stage."
- },
- "route_duration_ms": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Milliseconds for the whole refresh route invocation."
- },
- "rows_examined": {
- "description": "Documents the refresh examined to produce the counts above.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "stage": {
- "anyOf": [
- {
- "enum": [
- "parser_state",
- "coverage_snapshot",
- "complete"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "The stage the latest refresh reached: parser_state, then coverage_snapshot, then complete."
- },
- "state": {
- "description": "The recorded outcome of the latest coverage refresh; unevaluated when none has been recorded; unavailable when the record could not be read.",
- "enum": [
- "succeeded",
- "failed",
- "unevaluated",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "stage",
- "attempted_at",
- "completed_at",
- "age_seconds",
- "rows_examined",
- "parser_state_duration_ms",
- "coverage_refresh_duration_ms",
- "route_duration_ms",
- "error_code",
- "detail"
- ],
- "type": "object"
- },
- "requalification_hold": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "evidence_url": {
- "description": "Review receipt supporting the prerequisite; its presence does not assert that the repair has landed.",
- "format": "uri",
- "type": "string"
- },
- "reason": {
- "description": "Source-controlled reason for the parser rollout hold, independent of measured recovery counts and terminal failures.",
- "type": "string"
- },
- "release_condition": {
- "description": "Reviewed code-change condition required to resume parser requalification; it cannot be bypassed by an environment or request setting.",
- "type": "string"
- },
- "required_items": {
- "description": "Work-order item numbers whose reviewed owner-pair and stable-identity repairs are prerequisites for requalification.",
- "items": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "type": "array"
- },
- "state": {
- "const": "held",
- "description": "Parser requalification is held before claims, fetches or corpus writes; this policy state does not measure serving health.",
- "type": "string"
- }
- },
- "required": [
- "state",
- "reason",
- "required_items",
- "evidence_url",
- "release_condition"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "Source-controlled parser rollout hold and its reviewed release prerequisite. This progress field does not establish current data freshness or completed recovery."
- },
- "state": {
- "description": "ready: the stamped measurement is current and no House PTR recovery document remains pending, in progress or retryable-failed; terminal exclusions may remain and their count stays in failed_terminal. recovery_in_progress: retryable work remains. stale: the stamped measurement is older than its budget. unavailable: it could not be read or its classification is inconsistent with its counts. recovery_in_progress is background progress, not degraded served data, only when fresh successful recovery evidence has complete consistent counts and zero row loss, and independent serving checks are current. Stale or unavailable recovery, failed refreshes, unknown counts, row loss and missing or failing serving evidence still degrade the endpoint.",
- "enum": [
- "ready",
- "recovery_in_progress",
- "stale",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "computed_at",
- "is_stale",
- "documents_total",
- "pending",
- "in_progress",
- "failed",
- "failed_terminal",
- "parser_reparse_row_loss",
- "refresh_outcome",
- "detail"
- ],
- "type": "object"
- },
- "degraded_reasons": {
- "description": "Which checks pulled state down, and their measurements. Empty when ready. An unavailable response carries any observed read failures, including named timed_out deadlines; missing configuration has no measured read outcomes.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "check": {
- "description": "The check that failed, named as the block it lives in: source:<system>, source:<system>:index_reconciliation, bulk_export, bulk_export:merkle_root, coverage_recovery, congress_public_summary, temporal_conformance, temporal_window, pipeline:attendance, or pipeline:<cron>.",
- "minLength": 1,
- "type": "string"
- },
- "deadline_ms": {
- "description": "Per-read request budget in milliseconds; 500, independently applied to each status dependency.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "measured": {
- "description": "The measurement behind the failure, quoted with its numbers and timestamps, so a caller can act on it without diffing the block it came from.",
- "minLength": 1,
- "type": "string"
- },
- "state": {
- "description": "Present for an independently bounded status read that timed out or threw; no source freshness threshold is changed.",
- "enum": [
- "timed_out",
- "read_failed"
- ],
- "type": "string"
- }
- },
- "required": [
- "check",
- "measured"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "detail": {
- "description": "Present only on the unavailable body, naming what could not be read.",
- "type": "string"
- },
- "generated_at": {
- "description": "When this response was computed. Every age_seconds below is measured from this instant, so the block is internally consistent even when read from a cache.",
- "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"
- },
- "institutional_delivery": {
- "additionalProperties": false,
- "description": "A declared boundary, stated rather than discovered.",
- "properties": {
- "available": {
- "const": false,
- "description": "Always false in v1: no institutional delivery channel is offered through this endpoint.",
- "type": "boolean"
- },
- "reason": {
- "const": "first_party_provenance_not_proven",
- "description": "Institutional delivery remains a compile-time product boundary, not a live provenance measurement or the authorization check for the existing Free/Developer API. A dated, generation-pinned audit traces every served row to an allowlisted first-party collection channel through its source version. Missing links and unknown origins refuse the proof; a government receipt URL alone is not collection evidence. Retained history and the exact downloadable export are checked separately. The export is downloaded and verified against its published checksum, row hashes and Merkle root; its rows are reconciled to the pinned serving generation. Unattributed warehouse rows are reviewed individually and remain excluded unless original collection evidence supports attribution. A reviewed permanent exclusion records its reason and date. An unserved row with unresolved origin does not by itself prove contamination of the served corpus. Counsel reviews the applicable agreements and permitted uses in writing. A reviewed release then implements institutional authorization and delivery. Neither a successful technical audit nor an environment setting grants institutional rights. The clearing requirements are published at https://www.veridionmarkets.com/data-api#institutional-delivery.",
- "type": "string"
- }
- },
- "required": [
- "available",
- "reason"
- ],
- "type": "object"
- },
- "notice": {
- "description": "Standing guidance on reading this block: what no_data means, what degraded does and does not imply, and how to verify a download.",
- "type": "string"
- },
- "observation_delay": {
- "additionalProperties": false,
- "description": "Hours from a filing's filed_date to Veridion's first observation, per source. Published only over rows with verified continuity; withheld with the reason otherwise. Absent only on the unavailable body.",
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Whole seconds since computed_at at this read; null when the saved computation is unavailable."
- },
- "basis": {
- "description": "precomputed: reads a saved poll-time report, with no live aggregate fallback. Before 1.9.0 this carried the prose now in measurement_basis.",
- "minLength": 1,
- "type": "string"
- },
- "computed_at": {
- "description": "Start of the saved poll-time computation, never the request time. Null when no valid saved computation exists; stale reports retain their original instant with unavailable state.",
- "type": [
- "string",
- "null"
- ]
- },
- "expected_max_age_seconds": {
- "description": "86400: one daily producer cycle. A stale saved report withholds its distribution; an operational measurement freshness budget, not a service commitment.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "measurement_basis": {
- "description": "The measurement and eligibility rule, previously carried in basis; present on 1.9.0 responses.",
- "minLength": 1,
- "type": "string"
- },
- "methodology_version": {
- "description": "Eligibility revision requiring active served versions, matching assessment facts and daily poll evidence from filing through first observation; prior decisions remain in the append-only ledger.",
- "minLength": 1,
- "type": "string"
- },
- "sources": {
- "description": "One entry per eligible source, measured or unevaluated with its record.",
- "items": {
- "oneOf": [
- {
- "additionalProperties": false,
- "properties": {
- "continuity": {
- "additionalProperties": false,
- "description": "Recorded poll window counted in the distribution's statement; the configured start is not substituted for evidence.",
- "properties": {
- "configured_start_precedes_telemetry": {
- "description": "True when the configured source start precedes the earliest recorded poll day; that unsupported interval is excluded from measurements.",
- "type": "boolean"
- },
- "days_poll_succeeded": {
- "description": "Recorded source-days with at least one successful poll; each measured row also requires success on every day from filing through observation.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "telemetry_days": {
- "description": "Count of recorded source-days, not elapsed calendar days; missing days are not counted.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "telemetry_first_day": {
- "description": "Minimum observation_date in the source's daily poll ledger.",
- "type": "string"
- },
- "telemetry_last_day": {
- "description": "Maximum observation_date in the source's daily poll ledger.",
- "type": "string"
- }
- },
- "required": [
- "telemetry_first_day",
- "telemetry_last_day",
- "telemetry_days",
- "days_poll_succeeded",
- "configured_start_precedes_telemetry"
- ],
- "type": "object"
- },
- "max_hours": {
- "description": "The largest observation delay in the distribution, in hours.",
- "minimum": 0,
- "type": "number"
- },
- "measured_rows": {
- "description": "Rows in the distribution: served rows whose source has verified daily continuity for every day between filed_date and first observation.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "median_hours": {
- "description": "Median of first_observed_at minus filed_date, in hours, over measured_rows.",
- "minimum": 0,
- "type": "number"
- },
- "observation_started_on": {
- "description": "The configured day continuous observation of this source began.",
- "type": "string"
- },
- "p95_hours": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "95th percentile in hours; null when withheld under 100 rows."
- },
- "percentile_state": {
- "description": "withheld_small_n when measured_rows is under 100, in which case p95_hours is null.",
- "enum": [
- "measured",
- "withheld_small_n"
- ],
- "type": "string"
- },
- "population": {
- "additionalProperties": false,
- "description": "Served denominator and named exclusions, computed with the measured distribution.",
- "properties": {
- "excluded_rows": {
- "description": "Served source rows excluded from the distribution; equals the sum of named exclusion counts and served_rows minus measured_rows.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "exclusions": {
- "description": "Disjoint exclusion counts by reason, sorted by reason; an empty list means no served rows were excluded.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "reason": {
- "description": "Stored eligibility refusal or a missing daily-poll proof at read time; rows receive exactly one reason, never a guessed assessment.",
- "minLength": 1,
- "type": "string"
- },
- "rows": {
- "description": "Active served source rows assigned this exclusion reason in the distribution's statement.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "reason",
- "rows"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "served_rows": {
- "description": "Count of active retained row versions for this source in the statement computing the distribution; includes ineligible rows.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "served_rows",
- "excluded_rows",
- "exclusions"
- ],
- "type": "object"
- },
- "source_system": {
- "description": "The source measured. OGE is excluded by policy: one annual document is one event, not a distribution.",
- "enum": [
- "house_clerk",
- "senate_efd"
- ],
- "type": "string"
- },
- "state": {
- "const": "measured",
- "description": "A distribution is published for this source.",
- "type": "string"
- },
- "window_end": {
- "description": "Latest filed_date of a row in the distribution.",
- "type": "string"
- },
- "window_start": {
- "description": "Earliest filed_date of a row in the distribution.",
- "type": "string"
- }
- },
- "required": [
- "state",
- "source_system",
- "observation_started_on",
- "window_start",
- "window_end",
- "measured_rows",
- "median_hours",
- "p95_hours",
- "max_hours",
- "percentile_state",
- "population",
- "continuity"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "continuity": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "configured_start_precedes_telemetry": {
- "description": "true when observation_started_on is earlier than telemetry_first_day, so filings before the telemetry have no verified continuity and are not counted toward a distribution.",
- "type": "boolean"
- },
- "days_poll_succeeded": {
- "description": "Of telemetry_days, the days on which the poll succeeded.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "telemetry_days": {
- "description": "Count of recorded source-days, not elapsed calendar days; missing days are not counted.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "telemetry_first_day": {
- "description": "First day for which per-day poll telemetry exists for this source.",
- "type": "string"
- },
- "telemetry_last_day": {
- "description": "Most recent day of poll telemetry.",
- "type": "string"
- }
- },
- "required": [
- "telemetry_first_day",
- "telemetry_last_day",
- "telemetry_days",
- "days_poll_succeeded",
- "configured_start_precedes_telemetry"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "The continuity telemetry the eligibility rule reads; null when none exists."
- },
- "observation_started_on": {
- "description": "The configured day continuous observation began; null if none is configured.",
- "type": [
- "string",
- "null"
- ]
- },
- "population": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "excluded_rows": {
- "description": "Served source rows excluded from the distribution; equals the sum of named exclusion counts and served_rows minus measured_rows.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "exclusions": {
- "description": "Disjoint exclusion counts by reason, sorted by reason; an empty list means no served rows were excluded.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "reason": {
- "description": "Stored eligibility refusal or a missing daily-poll proof at read time; rows receive exactly one reason, never a guessed assessment.",
- "minLength": 1,
- "type": "string"
- },
- "rows": {
- "description": "Active served source rows assigned this exclusion reason in the distribution's statement.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "reason",
- "rows"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "served_rows": {
- "description": "Count of active retained row versions for this source in the statement computing the distribution; includes ineligible rows.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "served_rows",
- "excluded_rows",
- "exclusions"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "Measured served denominator and exclusions when the statement succeeds with no eligible rows; null when the distribution refuses or cannot be read."
- },
- "reason": {
- "description": "Why the distribution refused to publish, quoted from the measurement: for example the count of served rows without a current eligibility assessment.",
- "minLength": 1,
- "type": "string"
- },
- "source_system": {
- "description": "The source that was not measured.",
- "enum": [
- "house_clerk",
- "senate_efd"
- ],
- "type": "string"
- },
- "state": {
- "const": "unevaluated",
- "description": "No distribution is published for this source; reason and continuity carry the record behind the refusal.",
- "type": "string"
- }
- },
- "required": [
- "state",
- "source_system",
- "observation_started_on",
- "reason",
- "population",
- "continuity"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "state": {
- "description": "measured when every eligible source has a published distribution; partial when some do; unavailable when none does. Never degrades the endpoint: an unpublished distribution is a disclosed limit, not a failure of served rows.",
- "enum": [
- "measured",
- "partial",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "methodology_version",
- "state",
- "computed_at",
- "basis",
- "sources"
- ],
- "type": "object"
- },
- "owner_column_repair": {
- "additionalProperties": false,
- "description": "Unresolved owner-column repair documents from the existing repair ledger. Absent only when the core status read is unavailable; no missing measurement is treated as zero.",
- "properties": {
- "detail": {
- "description": "Named read or evidence-validation failure; null for a complete measurement.",
- "type": [
- "string",
- "null"
- ]
- },
- "documents_total": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents in the frozen owner-repair target population; null when not measured."
- },
- "failed_terminal": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Uncorrected documents in failed_terminal under the owner-repair version; not failures in the latest cron attempt."
- },
- "measured_at": {
- "description": "Instant this bounded evidence read began; not the filing or failure date.",
- "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": {
- "description": "clear means no terminal failures measured, not that pending repairs are complete. Unresolved or unreadable evidence degrades status.",
- "enum": [
- "clear",
- "unresolved",
- "unavailable"
- ],
- "type": "string"
- },
- "terminal_documents": {
- "description": "Terminal documents with matching retained reason, receipt and dates; missing attestations are counted separately.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "doc_id": {
- "description": "House Clerk document identifier in the frozen repair population.",
- "minLength": 1,
- "type": "string"
- },
- "filing_date": {
- "description": "Filing date recorded with the official document.",
- "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"
- },
- "reason": {
- "description": "Retained reason for this document's terminal repair failure.",
- "minLength": 1,
- "type": "string"
- },
- "source_url": {
- "description": "Official House Clerk PDF receipt recorded for this document.",
- "format": "uri",
- "type": "string"
- },
- "terminal_at": {
- "description": "Stored instant the repair reached terminal failure, not the current read time.",
- "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": [
- "doc_id",
- "reason",
- "source_url",
- "filing_date",
- "terminal_at"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "unattested_documents": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Terminal documents omitted because receipt or terminal evidence was missing or changed during the read; null when the population is unavailable."
- }
- },
- "required": [
- "state",
- "measured_at",
- "documents_total",
- "failed_terminal",
- "terminal_documents",
- "unattested_documents",
- "detail"
- ],
- "type": "object"
- },
- "paper_transcriptions": {
- "additionalProperties": false,
- "description": "House paper queue measurement and per-member pending visibility. Known pending work alone is not an outage; failed reads are named and counts withheld.",
- "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"
- },
- "pipeline": {
- "additionalProperties": false,
- "description": "Attendance of the jobs that produce this API's data, from the cron attendance store. Absent only on the fail-closed 503 body. A missed, died or never-run job, a failed export run, or an unreadable store degrades the endpoint by name.",
- "properties": {
- "attendance_exemptions": {
- "description": "Named reviewed bootstrap exemptions, not measured successes. Included in scheduled and unwrapped totals, excluded only from required coverage.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "approved_on": {
- "description": "Date of the recorded exemption ruling.",
- "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"
- },
- "decision": {
- "description": "Work-order reference approving this named exemption.",
- "minLength": 1,
- "type": "string"
- },
- "reason": {
- "description": "Why this route must remain outside attendance admission.",
- "minLength": 1,
- "type": "string"
- },
- "route": {
- "description": "Exact scheduled pathname exempt from attendance admission.",
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "route",
- "reason",
- "approved_on",
- "decision"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "basis": {
- "description": "The full statement of how attendance is measured: the store, the two units, slot attribution and its tolerance, and what each job state means. Carried on every response so the numbers never travel without their rules.",
- "minLength": 1,
- "type": "string"
- },
- "deprecated_fields": {
- "description": "Fields in this block that are kept for compatibility and should not be read for new work.",
- "items": {
- "minLength": 1,
- "type": "string"
- },
- "type": "array"
- },
- "detail": {
- "description": "When instrumentation is partial or exemptions apply, total and required coverage from the same attendance report. Otherwise the unavailable or empty-job explanation, or null when fully instrumented and readable.",
- "type": [
- "string",
- "null"
- ]
- },
- "exempt_invocations": {
- "description": "Distinct scheduled invocations belonging to the named uninstrumented route exemptions.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "exempt_routes": {
- "description": "Number of named uninstrumented route exemptions in this response.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "field_successors": {
- "additionalProperties": {
- "minLength": 1,
- "type": "string"
- },
- "description": "For each deprecated field, the field that carries the same value under its correct name.",
- "propertyNames": {
- "minLength": 1,
- "type": "string"
- },
- "type": "object"
- },
- "instrumented_invocations": {
- "description": "Distinct scheduled invocations (pathname plus query) whose route records attendance. One route scheduled under several query shapes counts once per shape, because a due slot belongs to one invocation.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "instrumented_jobs": {
- "description": "Deprecated in 1.3.14; the same value as instrumented_invocations. Kept for additive compatibility.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "instrumented_routes": {
- "description": "Distinct cron pathnames that record attendance. This is the coverage figure: read it, not the invocation pair, when asking how much of the cron surface is watched.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "jobs": {
- "description": "The jobs that produce this API's data, one entry per invocation shape observed or scheduled.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "coverage_start": {
- "description": "Earliest attendance started_at for this pathname, across query variants, from the full ledger. Null means no route observation evidence. Added in item 551.",
- "type": [
- "string",
- "null"
- ]
- },
- "cron_name": {
- "description": "The invocation as scheduled: pathname plus query string, exactly as vercel.json lists it.",
- "minLength": 1,
- "type": "string"
- },
- "died_count": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Runs in the window that started and never finished within their ceiling, including ones a later run has since superseded. History; the state field describes now."
- },
- "expected_slots_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Due slots from max(window start, coverage_start), counted after the complete schedule minute."
- },
- "last_ok": {
- "description": "When the job last completed successfully; null if never.",
- "type": [
- "string",
- "null"
- ]
- },
- "latest_run": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "error": {
- "description": "The run's own error text, with credentials and URLs redacted; null on success.",
- "type": [
- "string",
- "null"
- ]
- },
- "finished_at": {
- "description": "When the latest run finished; null while running or after it died.",
- "type": [
- "string",
- "null"
- ]
- },
- "http_status": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "The HTTP status the run returned; null while running."
- },
- "ok": {
- "description": "Whether the latest run reported success; null until it finishes.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "rows_written": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Rows the latest run wrote, in the unit rows_written_basis names; null when the run did not report one."
- },
- "rows_written_basis": {
- "description": "What rows_written counts, named per route, because a row means different things to different jobs.",
- "type": "string"
- },
- "started_at": {
- "description": "When the latest run started.",
- "type": "string"
- }
- },
- "required": [
- "started_at",
- "finished_at",
- "ok",
- "rows_written",
- "rows_written_basis",
- "http_status",
- "error"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "The most recent run of this invocation; null when it has never run."
- },
- "missed_count_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "expected_slots_24h minus observed_slots_24h."
- },
- "not_yet_observed_slots_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Scheduled slots before coverage_start in this 24-hour window; not missed. Null when attendance cannot be read. Added in item 551."
- },
- "observed_slots_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Due slots in the window that a run was attributed to."
- },
- "scheduled_job": {
- "description": "false for an invocation shape that appears in no vercel.json entry. It has no due slots and cannot miss one; it is listed rather than hidden.",
- "type": "boolean"
- },
- "schedules": {
- "description": "Every cron expression vercel.json schedules this invocation under; empty when it appears in none.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "state": {
- "description": "The job now, not the last 24 hours. missed: a due slot with no run attributed. died: the latest attempt started and never finished within its ceiling. failed: the latest run returned an error. wrote_zero: the latest run succeeded and wrote no rows. write_count_unavailable: succeeded, count unreadable. running: the latest run has not finished and is within its ceiling. never_ran: no run recorded although slots were due after route coverage began. not_yet_observed: no run and no route coverage yet. unevaluated: attendance could not be read, or no run and no due slot yet. unwrapped: the route records no attendance. Precedence in that order when several apply.",
- "enum": [
- "unwrapped",
- "unevaluated",
- "not_yet_observed",
- "never_ran",
- "missed",
- "running",
- "died",
- "failed",
- "wrote_zero",
- "write_count_unavailable",
- "succeeded"
- ],
- "type": "string"
- },
- "unattributed_runs_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Runs that started in the window and attribute to no due slot, counted rather than dropped, because they ran."
- }
- },
- "required": [
- "cron_name",
- "schedules",
- "scheduled_job",
- "state",
- "expected_slots_24h",
- "observed_slots_24h",
- "missed_count_24h",
- "unattributed_runs_24h",
- "died_count",
- "last_ok",
- "latest_run"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "measured_at": {
- "description": "When attendance was evaluated; the 24-hour window ends here.",
- "type": "string"
- },
- "observation_started_at": {
- "description": "When the attendance instrument was installed. Due slots are counted only after this instant.",
- "type": [
- "string",
- "null"
- ]
- },
- "required_invocations": {
- "description": "scheduled_invocations minus exempt_invocations; an exemption never manufactures attendance.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "required_routes": {
- "description": "scheduled_routes minus exempt_routes; instrumentation must cover every required route.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "schedule_entries": {
- "description": "Lines in vercel.json's cron list. Exceeds scheduled_invocations when one URL carries more than one schedule.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "scheduled_invocations": {
- "description": "instrumented_invocations plus unwrapped_invocations: every distinct invocation in vercel.json.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "scheduled_jobs": {
- "description": "Deprecated in 1.3.14; the same value as scheduled_invocations.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "scheduled_routes": {
- "description": "instrumented_routes plus unwrapped_routes: every distinct cron pathname in vercel.json.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "state": {
- "description": "degraded when any listed job is not delivering: no successful completion since its most recent due slot, its latest run died, it has never run, or (export job only) its latest run failed. unavailable when the attendance store could not be read, which also degrades the endpoint. Otherwise partial when any required invocation or route is unwrapped; ready requires complete required instrumentation and no listed delivery failure. Named attendance_exemptions remain in scheduled and unwrapped totals. Partial also degrades the overall endpoint with pipeline:coverage.",
- "enum": [
- "ready",
- "partial",
- "degraded",
- "unavailable"
- ],
- "type": "string"
- },
- "unwrapped_invocations": {
- "description": "Distinct scheduled invocations whose route records no attendance.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "unwrapped_jobs": {
- "description": "Deprecated in 1.3.14; the same value as unwrapped_invocations.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "unwrapped_routes": {
- "description": "Distinct cron pathnames that record no attendance.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "state",
- "measured_at",
- "observation_started_at",
- "instrumented_jobs",
- "unwrapped_jobs",
- "scheduled_jobs",
- "instrumented_invocations",
- "unwrapped_invocations",
- "scheduled_invocations",
- "instrumented_routes",
- "unwrapped_routes",
- "scheduled_routes",
- "schedule_entries",
- "deprecated_fields",
- "field_successors",
- "basis",
- "detail",
- "jobs"
- ],
- "type": "object"
- },
- "sources": {
- "description": "Freshness of every source Veridion polls, measured from the same table the serving views read. One entry per source system, including the ones that publish nothing.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus last_success_at, in whole seconds; null when there is no success to measure from."
- },
- "detail": {
- "description": "OGE: producer, verdict, last completion, measured age, threshold and current failure or uncertainty, computed from the same evidence as the verdict. Other sources retain their stored explanation; sec_edgar states its no_data boundary.",
- "type": [
- "string",
- "null"
- ]
- },
- "expected_max_age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "The age past which the source reads stale: 86400 for House Clerk and Senate eFD. OGE uses two maximum daily schedule gaps from vercel.json plus the late-start allowance and run ceiling; it ages successful producer completions, not annual filings. Null for sec_edgar which has no poll to age."
- },
- "failure_since": {
- "description": "OGE: start of the first failed run after the last successful completion, ordered by (finished_at, run_id) over the whole attendance ledger, not its 24-hour row window. Null when no failed streak exists or attendance is unavailable. Senate uses the failed index-run streak; House does not measure this field.",
- "type": [
- "string",
- "null"
- ]
- },
- "index_reconciliation": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "age_seconds": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus checked_at, in whole seconds, floored at zero; null when checked_at is null."
- },
- "checked_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": "When the hourly ingest run last reconciled the House Clerk's searchable PTR index against the warehouse; null when no reconciliation has been stored."
- },
- "cutoff_date": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "The earliest filing date the reconciliation examined: the check date minus 14 days. Documents filed before it are outside this measurement."
- },
- "documents_on_index": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents the Clerk's index listed with a filing date on or after cutoff_date at the last check; null when the index could not be read."
- },
- "expected_max_age_seconds": {
- "description": "The age past which the reconciliation is reported unmeasured: 21600 (6 h), the same threshold as the Congress summary, because the same hourly ingest cadence refreshes both. An operational alerting threshold, not a service commitment.",
- "minimum": 0,
- "type": "number"
- },
- "latest_index_filing_date": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "The newest filing date among documents_on_index; null when there are none."
- },
- "latest_served_filing_date": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "The newest filing date among parsed_documents; the gap to latest_index_filing_date is the visible lag of the served corpus behind the government index."
- },
- "parsed_documents": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Of documents_on_index, those the parser finished with qualifying rows that are served."
- },
- "state": {
- "description": "current: every document on the index since cutoff_date is accounted for (parsed, or terminal without qualifying rows). unaccounted: at least one is not. index_unavailable: the government index could not be read at the last check. unmeasured: no reconciliation newer than expected_max_age_seconds.",
- "enum": [
- "current",
- "unaccounted",
- "index_unavailable",
- "unmeasured"
- ],
- "type": "string"
- },
- "terminal_without_rows": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents the parser finished and found no qualifying transaction rows in; accounted for, not served."
- },
- "unaccounted_documents": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Documents on the index since cutoff_date that are neither served nor terminal without rows, plus any document the discovery pass could not fetch. Any value above zero degrades the endpoint."
- },
- "unaccounted_sample": {
- "description": "Up to five unaccounted documents with the recorded reason.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "doc_id": {
- "description": "The House Clerk DocID of the unaccounted filing.",
- "minLength": 1,
- "type": "string"
- },
- "filing_date": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "The filing date the index lists for it; null when the index gave none."
- },
- "reason": {
- "description": "The recorded overlay status and reason, as status:reason, or overlay_row_missing when the document was never attempted, truncated to 200 characters.",
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "doc_id",
- "filing_date",
- "reason"
- ],
- "type": "object"
- },
- "type": "array"
- }
- },
- "required": [
- "state",
- "checked_at",
- "age_seconds",
- "expected_max_age_seconds",
- "cutoff_date",
- "documents_on_index",
- "parsed_documents",
- "terminal_without_rows",
- "unaccounted_documents",
- "latest_index_filing_date",
- "latest_served_filing_date",
- "unaccounted_sample"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "The government's own index reconciled against what this API serves, when a source publishes an index we can read (House Clerk PTR search). Age says when we last succeeded; this says whether the index lists filings we do not yet account for. Null for sources without a readable index."
- },
- "last_row_observed_at": {
- "description": "House only: latest qualified receipt row observation from the source view, preserved separately when the newer official index check establishes source freshness. Null when no qualified row exists.",
- "type": [
- "string",
- "null"
- ]
- },
- "last_success_at": {
- "description": "OGE: last successful terminal completion in cron attendance, not a filing date. Senate: latest completed index run. House: later of latest qualified receipt row observation and a current, complete official index reconciliation within its six-hour budget. Null when unavailable or never observed; these bases are distinct.",
- "type": [
- "string",
- "null"
- ]
- },
- "source_system": {
- "description": "house_clerk, senate_efd, oge or sec_edgar. sec_edgar is listed in no_data state as a declared scope boundary, so a reader learns it from the response rather than from a query that returns nothing.",
- "type": [
- "string",
- "null"
- ]
- },
- "state": {
- "description": "ready: the source observation is within expected_max_age_seconds. For OGE this is a successful producer completion, including zero-row polls; two consecutive failed completions instead report degraded. unknown means attendance or a successful completion is unavailable. stale: the stored state says ready but last_success_at is older than the threshold; the worse of the two is reported. source_unavailable: the most recent poll failed. no_data: the source publishes no rows into v1 by policy. unknown: the stored state was unreadable.",
- "minLength": 1,
- "type": "string"
- },
- "threshold_basis": {
- "description": "Operational alerting rule, not a service commitment. OGE names its producing job, consecutive-failure threshold, configured UTC schedules, maximum schedule gap, late-start allowance and run ceiling; the age budget is computed from those values.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "source_system",
- "state",
- "last_success_at",
- "failure_since",
- "age_seconds",
- "expected_max_age_seconds",
- "threshold_basis",
- "detail",
- "index_reconciliation"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "state": {
- "description": "ready when no check below is failing. degraded when any source is stale or unavailable, the export is stale, unavailable or missing its merkle_root, coverage recovery is stale or unavailable, the Congress summary is stale, unavailable or unattested, a temporal-conformance contract fails, the temporal window is unreadable, the House index lists unaccounted filings, or a pipeline job is not delivering. unavailable when the status itself could not be measured. The endpoint never reports a state more optimistic than its own arithmetic: a stored 'ready' older than its threshold is reported stale.",
- "enum": [
- "ready",
- "degraded",
- "unavailable"
- ],
- "type": "string"
- },
- "temporal_conformance": {
- "additionalProperties": false,
- "description": "The four temporal contracts, verified against the pinned bulk snapshot. A failing contract degrades the endpoint by name. Absent only on the unavailable body.",
- "properties": {
- "computed_at": {
- "description": "When the contracts were last verified, against the pinned bulk snapshot.",
- "type": [
- "string",
- "null"
- ]
- },
- "contracts": {
- "description": "One entry per contract, T1 through T4.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "contract": {
- "description": "T1: point-in-time reads exclude later versions. T2: pagination stays fixed while writes continue. T3: incremental sync reconstructs the full set. T4: restatements preserve permanent row identity.",
- "enum": [
- "T1",
- "T2",
- "T3",
- "T4"
- ],
- "type": "string"
- },
- "rows_examined": {
- "description": "Rows the contract was checked over.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "state": {
- "description": "pass with zero violations; fail with the count; unevaluated when the evidence is missing.",
- "enum": [
- "pass",
- "fail",
- "unevaluated"
- ],
- "type": "string"
- },
- "verified_on": {
- "description": "The UTC day the contract was last verified.",
- "type": [
- "string",
- "null"
- ]
- },
- "violations": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Rows that broke the contract; null when unevaluated."
- }
- },
- "required": [
- "contract",
- "state",
- "violations",
- "rows_examined",
- "verified_on"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "state": {
- "description": "ready when every contract passed on the pinned snapshot; degraded when any failed; unavailable when the snapshot could not be read.",
- "enum": [
- "ready",
- "degraded",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "computed_at",
- "contracts"
- ],
- "type": "object"
- },
- "temporal_window": {
- "additionalProperties": false,
- "description": "How far back as_of reads can go. The floor is the activation instant of retained payload history; depth is the time since. Neither says anything about filing completeness before the floor, which is what /v1/coverage measures.",
- "properties": {
- "basis": {
- "description": "The sentence stating how the floor and depth are measured, carried on every response.",
- "minLength": 1,
- "type": "string"
- },
- "depth_days": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Unrounded (measured_at - point_in_time_floor) / 86400000 milliseconds. Temporal depth is not filing completeness; null means unmeasured."
- },
- "detail": {
- "description": "Why the window is unavailable, when it is; null when available.",
- "type": [
- "string",
- "null"
- ]
- },
- "measured_at": {
- "description": "The instant depth_days was measured against; equals 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"
- },
- "point_in_time_floor": {
- "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": "Inclusive millisecond boundary from the same temporal dataset-state resolver used by disclosure queries; null if unreadable."
- },
- "retention_regime": {
- "const": "growing",
- "description": "Retained versions are close-only and generations append-only; the current mechanism has no age-based rolling prune.",
- "type": "string"
- },
- "state": {
- "description": "available when the temporal dataset-state resolver answered; unavailable when it did not, which degrades the endpoint with the reason in detail.",
- "enum": [
- "available",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "point_in_time_floor",
- "depth_days",
- "measured_at",
- "retention_regime",
- "basis",
- "detail"
- ],
- "type": "object"
- },
- "track_record": {
- "additionalProperties": false,
- "description": "When the published track record was last successfully computed, and whether the latest run succeeded. The figures a buyer reads on /track-record are dated by published_at; this block lets a pipeline learn that date, and learn that a later run failed, without scraping the page. Read live from two indexed single-row lookups, so unlike universe it carries no measurement age of its own. Absent only on the unavailable body, where no read was attempted.",
- "properties": {
- "attempt_newer_than_publication": {
- "description": "True when a run is recorded after the last successful publication. Paired with a failed last_attempt_status this is the case a publication instant alone hides: the served cells are real and correctly dated, and the pipeline has since tried to replace them and could not. Measured on production 2026-09-19, 356 of 547 recorded runs are failures, so this is a normal condition rather than an edge case.",
- "type": "boolean"
- },
- "detail": {
- "description": "What the state and the attempt mean, in words, so the block is readable without this schema.",
- "type": "string"
- },
- "last_attempt_age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus last_attempt_at. How long ago the pipeline last tried."
- },
- "last_attempt_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": "When the most recent run was recorded, whatever its outcome."
- },
- "last_attempt_status": {
- "description": "Outcome of the most recent recorded run. insufficient_history means the run completed and honestly declined to publish for want of matured history — an outcome, not a failure, and it does not degrade this endpoint.",
- "enum": [
- "completed",
- "insufficient_history",
- "failed",
- "unavailable"
- ],
- "type": "string"
- },
- "published_age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus published_at. How old the served track-record figures are."
- },
- "published_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": "When the cells currently served were computed. This is the last SUCCESSFUL publication, not the last run: a failed run does not move it."
- },
- "state": {
- "description": "Freshness of the published track record itself: live when the last successful publication is inside its expected cadence, stale when it is not, unavailable when the publication record could not be read. The same state the /track-record page renders, from the same reading.",
- "enum": [
- "live",
- "stale",
- "unavailable"
- ],
- "type": "string"
- }
- },
- "required": [
- "state",
- "published_at",
- "published_age_seconds",
- "last_attempt_status",
- "last_attempt_at",
- "last_attempt_age_seconds",
- "attempt_newer_than_publication",
- "detail"
- ],
- "type": "object"
- },
- "universe": {
- "additionalProperties": false,
- "description": "How fresh the scored universe is. A buyer's first question about a score is how old it is, and the answer is a distribution: newest, median, oldest, and the share scored inside a day. Measured on a cron and read as one stored row; the block reports the age of its own measurement so a stale measurement cannot masquerade as a current one. Absent only on the unavailable body, where no read was attempted at all: this endpoint does not publish a block it did not measure.",
- "properties": {
- "census_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": "Instant of the census captured with this intersection, in millisecond ISO-8601 Z form. The enclosing measured_at dates the intersection. Never taken from an independently newer census; null without valid paired evidence."
- },
- "census_trading_day": {
- "anyOf": [
- {
- "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"
- },
- {
- "type": "null"
- }
- ],
- "description": "Trading day of the qualified census captured with this intersection, not the latest census or latest scored trading day at request time. Null without valid paired evidence."
- },
- "coverage_share": {
- "anyOf": [
- {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "scored_qualified_count divided by qualified_count, without display rounding. Both counts belong to this measured_at and this census identity. Null for missing or invalid evidence or a zero denominator; zero only for a measured empty intersection with a nonempty qualified set."
- },
- "detail": {
- "description": "What the state and the spread mean, in words, so the block is readable without this schema.",
- "type": "string"
- },
- "last_scored_age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus last_scored_at. The age of the freshest score, not of the universe."
- },
- "last_scored_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": "The NEWEST score in the universe. Read it with oldest_scored_at: on 2026-09-19 the newest was seven minutes old and the oldest was thirty-one days old, so this field alone would describe the universe as fresher than it is."
- },
- "latest_trading_day": {
- "description": "The most recent trading day any symbol in the universe was scored for.",
- "type": [
- "string",
- "null"
- ]
- },
- "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": "When the universe was measured, not when this response was generated. The aggregate is taken on a cron because measuring it live costs roughly 624 ms, past this endpoint's read deadline."
- },
- "measurement_age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus measured_at. How old the measurement is, not how old the scores are."
- },
- "measurement_max_age_seconds": {
- "description": "The age past which the measurement is called stale and the endpoint degrades. A bound this response was checked against, not a service commitment.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "median_scored_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": "The middle of the distribution: half the universe was scored no earlier than this."
- },
- "methodology_version": {
- "description": "The scoring methodology version the universe view selected as current.",
- "type": [
- "string",
- "null"
- ]
- },
- "methodology_versions": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Distinct methodology versions present in the universe. Item 364: this is 1 by construction, because the view filters to the single current version, so it cannot signal a mid-migration universe. It previously claimed it could."
- },
- "older_than_7d": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Scored symbols whose score is more than seven days old at measured_at. Published rather than hidden."
- },
- "oldest_scored_age_seconds": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "generated_at minus oldest_scored_at. The worst case a consumer of the scores can meet."
- },
- "oldest_scored_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": "The FLOOR of the universe: the least recently scored symbol. This is the field that makes last_scored_at honest, and the reason this block publishes a distribution rather than a headline."
- },
- "population_basis": {
- "description": "What symbols and scored actually count, and which figures in this block are identities rather than measurements. Published because a reader who divides scored by symbols gets 100% on every call and would reasonably read that as full coverage.",
- "type": "string"
- },
- "qualified_count": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Exact denominator: cardinality of the unique qualified symbol set captured with this intersection. Null without valid paired evidence, including historical count-only census rows."
- },
- "scored": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Equal to symbols by construction and unable to differ from it: both count the same rows. This is an identity, not a coverage measurement, and scored/symbols is not a coverage ratio. Every freshness figure below IS measured over these rows."
- },
- "scored_qualified_count": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Exact numerator: current-methodology scored symbols intersected with the stored qualified set at measured_at. Excludes scored names outside that set; null without valid paired evidence."
- },
- "scored_within_24h": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Scored symbols whose score was computed inside the twenty-four hours before measured_at."
- },
- "scored_within_24h_share": {
- "anyOf": [
- {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "scored_within_24h divided by scored, rounded to four places. Below four in five, the detail says so rather than leaving the reader to divide."
- },
- "state": {
- "description": "measured when a current measurement was read. measurement_stale when the measurement itself is older than measurement_max_age_seconds, in which case every figure below describes the universe as of measured_at, not as of now. unmeasured when no measurement has been recorded yet. unavailable when the stored measurement could not be read. The last two are different facts and are reported as different states.",
- "enum": [
- "measured",
- "measurement_stale",
- "unmeasured",
- "unavailable"
- ],
- "type": "string"
- },
- "symbols": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Symbols carrying a score under the CURRENT methodology_version. Item 364: this field previously read \"including any not yet scored\", which was false -- the coverage view is built from score_snapshots, so an unscored symbol is not a row. Read population_basis before dividing this by anything."
- }
- },
- "required": [
- "state",
- "measured_at",
- "measurement_age_seconds",
- "measurement_max_age_seconds",
- "symbols",
- "scored",
- "scored_qualified_count",
- "qualified_count",
- "coverage_share",
- "census_trading_day",
- "census_measured_at",
- "last_scored_at",
- "last_scored_age_seconds",
- "median_scored_at",
- "oldest_scored_at",
- "oldest_scored_age_seconds",
- "scored_within_24h",
- "scored_within_24h_share",
- "older_than_7d",
- "latest_trading_day",
- "methodology_version",
- "methodology_versions",
- "population_basis",
- "detail"
- ],
- "type": "object"
- },
- "version": {
- "const": "1.20.0",
- "description": "The contract version this response was produced under; the same value as X-API-Version.",
- "type": "string"
- }
- },
- "required": [
- "paper_transcriptions",
- "billing_gate",
- "version",
- "generated_at",
- "cache",
- "state",
- "temporal_window",
- "degraded_reasons",
- "sources",
- "institutional_delivery"
- ],
- "type": "object"
-}New value: +null