addedOutput schema / properties / data / items / properties / paper_transcriptions
Added value: +{
+ "additionalProperties": false,
+ "description": "This known filer's paper queue state from the independent paper measurement, without changing directory disclosure counts.",
+ "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"
+}
addedOutput schema / properties / paper_transcriptions
Added value: +{
+ "additionalProperties": false,
+ "description": "Paper queue visibility independent of the directory population and measurement timestamp. Completeness state describes the annual paper measurement, not roster coverage.",
+ "properties": {
+ "archive_year": {
+ "description": "Clerk annual filing-index year being reconciled.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "by_member": {
+ "description": "Observed paper filers matching the declared filter scope, including filers absent from the legacy roster when metadata supports matching. Does not add roster rows or alter directory counts.",
+ "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"
+ },
+ "filter_coverage": {
+ "description": "Paper metadata supports exact member, name and House chamber filters. State or Bioguide filters can only admit members proven by directory records in this response; their paper-only matches remain unknown.",
+ "enum": [
+ "paper_metadata",
+ "directory_response_only"
+ ],
+ "type": "string"
+ },
+ "filter_reason": {
+ "description": "Named limitation when directory identity is needed to evaluate filters, otherwise null. An empty restricted list is not proof that no matching paper filings exist.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filters": {
+ "additionalProperties": false,
+ "description": "Member filters applied to the independent paper list; directory cursor and limit do not paginate this list.",
+ "properties": {
+ "bioguide": {
+ "description": "Requested Bioguide; requires a matching known directory record and is never invented for pending-only filers.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "chamber": {
+ "description": "Requested chamber; this paper queue contains House documents only.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "member_id": {
+ "description": "Exact canonical member filter, or null for all matching members.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Literal case-insensitive substring applied to retained paper member names, not a wildcard.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "state": {
+ "description": "Requested state; requires a matching known directory record and is not inferred from a member name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "member_id",
+ "name",
+ "chamber",
+ "state",
+ "bioguide"
+ ],
+ "type": "object"
+ },
+ "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."
+ },
+ "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"
+ }
+ },
+ "required": [
+ "state",
+ "reason",
+ "archive_year",
+ "measured_at",
+ "filters",
+ "filter_coverage",
+ "filter_reason",
+ "by_member"
+ ],
+ "type": "object"
+}