{"openapi":"3.1.0","info":{"title":"Civic Result Maps Public API","version":"1.0.0","description":"Versioned, source-aware access to canonical U.S. county election results and comparison data. Advisory context identifies review questions and data gaps; it is not evidence of fraud or misconduct.","license":{"name":"Public data; consult each source artifact for its terms"}},"servers":[{"url":"https://www.civicresultmaps.org","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"tags":[{"name":"Comparisons","description":"Canonical county election comparisons"},{"name":"Counties","description":"County registry, search, and profiles"},{"name":"Districts","description":"Plan-vintage district boundary measurements and explicit comparability guards"},{"name":"Releases","description":"Immutable result, equipment, and security release metadata and bulk downloads"},{"name":"Equipment","description":"Source-linked certified configurations, change records, and evidence gaps"},{"name":"Connections","description":"Reviewed documentary relationships and result source lineage"},{"name":"Platform","description":"Existing state, source, and coverage endpoints"}],"paths":{"/api/v1/connections":{"get":{"tags":["Connections"],"operationId":"getReviewedConnections","summary":"Get the currently published documentary connections release","description":"Explicitly enabled, publisher-reviewed snapshots only. Disabled or unavailable releases return 503; private drafts and the legacy catalog are never substituted. Full retained documents remain private.","responses":{"200":{"description":"Reviewed connections with pinned source revisions and exact passages.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionsEnvelope"}}}},"503":{"description":"Releases disabled, unconfigured, or unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/connections/sources/{id}":{"get":{"tags":["Connections"],"operationId":"getPublishedConnectionSourceRevision","summary":"Get metadata and passages for one published source revision","parameters":[{"name":"id","in":"path","required":true,"description":"Immutable revision ID, not the source registry ID.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"}}],"responses":{"200":{"description":"Public metadata and short passages; no private copies or storage paths.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionSourceRevisionEnvelope"}}}},"404":{"description":"Revision is not in the current public release.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Reviewed releases are disabled or unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/result-lineage":{"get":{"tags":["Connections"],"operationId":"inspectResultLineage","summary":"Inspect Texas 2024 county presidential candidate source and import checks","description":"Feature-gated initial pilot. A stable stored data revision is required. Exact raw County.json pointers, an approved retained JSON revision, and recorded import fingerprints are checked separately. The browser must independently compare these votes to its displayed values. No seed or inferred chain is substituted.","parameters":[{"name":"state","in":"query","required":true,"schema":{"const":"TX"}},{"name":"year","in":"query","required":true,"schema":{"const":"2024"}},{"name":"office","in":"query","required":true,"schema":{"const":"president"}},{"name":"level","in":"query","required":true,"schema":{"const":"county"}},{"name":"jurisdictionCode","in":"query","required":true,"description":"Stored jurisdiction code, county:48xxx tag, or five-digit Texas county FIPS.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"dataRevision","in":"query","description":"Optional expected revision returned by /api/results; stale tokens return 409.","schema":{"type":"string"}}],"responses":{"200":{"description":"Candidate checks; incomplete lineage is reported as incomplete, not verified.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultLineageEnvelope"}}}},"400":{"description":"Unsupported selection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Matching official county rows are absent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Requested revision is stale or the public-data revision changed during inspection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Pilot disabled, database unavailable, migration absent, or rows ambiguous.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/flips":{"get":{"tags":["Comparisons"],"operationId":"listCountyComparisons","summary":"List county flips and non-flips for a presidential year pair","parameters":[{"name":"from","in":"query","schema":{"type":"integer","enum":[2016,2020,2024],"default":2020}},{"name":"to","in":"query","schema":{"type":"integer","enum":[2016,2020,2024],"default":2024}},{"name":"direction","in":"query","schema":{"type":"string","enum":["all","red_to_blue","blue_to_red","no_flip"],"default":"all"}},{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"fips","in":"query","schema":{"type":"string","pattern":"^[0-9]{5}$"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","description":"Full JSON is capped at 1,000 rows; compact JSON and CSV support up to 5,000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":250}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"view","in":"query","description":"Compact omits optional per-snapshot provenance fields while retaining row-level confidence and caveats.","schema":{"type":"string","enum":["full","compact"],"default":"full"}}],"responses":{"200":{"description":"A paginated comparison envelope or CSV export.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonEnvelope"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"The request could not be parsed or validated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/counties/{fips}":{"get":{"tags":["Counties"],"operationId":"getCountyProfile","summary":"Get a permanent county profile by five-digit FIPS","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{5}$"}}],"responses":{"200":{"description":"County profile with presidential history and available contextual data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountyProfileEnvelope"}}}},"400":{"description":"FIPS must be exactly five digits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"FIPS is not in the canonical registry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/jurisdictions":{"get":{"tags":["Counties"],"operationId":"listCanonicalCounties","summary":"List the canonical county and county-equivalent registry","parameters":[{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"fips","in":"query","schema":{"type":"string","pattern":"^[0-9]{5}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":5000,"default":250}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Paginated canonical county registry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JurisdictionEnvelope"}}}},"400":{"description":"The request could not be parsed or validated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/jurisdictions/search":{"get":{"tags":["Counties"],"operationId":"searchCounties","summary":"Search canonical counties by FIPS, name, or alias","parameters":[{"name":"q","in":"query","description":"Optional when state is provided.","schema":{"type":"string","maxLength":120}},{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Paginated canonical county search results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountySearchEnvelope"}}}},"400":{"description":"The request could not be parsed or validated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/confidence":{"get":{"tags":["Platform"],"operationId":"listConfidenceDefinitions","summary":"List the stable data-confidence vocabulary","responses":{"200":{"description":"Confidence definitions used throughout the platform.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfidenceDefinitionEnvelope"}}}}}}},"/api/v1/releases":{"get":{"tags":["Releases"],"operationId":"listReleases","summary":"List public data releases","responses":{"200":{"description":"Release catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseCatalogEnvelope"}}}}}}},"/api/v1/releases/{releaseId}":{"get":{"tags":["Releases"],"operationId":"getRelease","summary":"Get one immutable release manifest","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release manifest.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseEnvelope"}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/releases/{releaseId}/download":{"get":{"tags":["Releases"],"operationId":"downloadRelease","summary":"Download an immutable public data release ZIP","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"307":{"description":"Redirect to the immutable, content-addressed release ZIP.","headers":{"Location":{"schema":{"type":"string"}},"X-Archive-Sha256":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"X-Data-Sha256":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"X-Release-Id":{"schema":{"type":"string"}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/equipment-systems":{"get":{"tags":["Equipment"],"operationId":"listEquipmentSystems","summary":"List reviewed election-equipment system dossiers","description":"Feature-gated pilot. Certified configurations and jurisdiction deployment observations remain separate evidence scopes.","responses":{"200":{"description":"Reviewed equipment-system summaries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentSystemListEnvelope"}}}},"404":{"description":"The equipment catalog pilot is not enabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/equipment-systems/compare":{"get":{"tags":["Equipment"],"operationId":"compareEquipmentSystems","summary":"Compare two or three reviewed equipment dossiers","description":"Returns ordered, comparison-safe certification, component, network, history, usage-relation, and source fields without ranking the systems.","parameters":[{"name":"slugs","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","minItems":2,"maxItems":3,"uniqueItems":true,"items":{"type":"string"}}}],"responses":{"200":{"description":"Two or three reviewed dossier comparisons in requested order.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentComparisonEnvelope"}}}},"400":{"description":"Comparison requires two or three distinct known slugs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The equipment catalog is not enabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/equipment-states/{state}":{"get":{"tags":["Equipment"],"operationId":"getEquipmentStateContext","summary":"Get exact product-family and manufacturer context for one state","description":"Exact product-family relations target reviewed dossiers. Vendor-only observations are grouped once by manufacturer and do not become dossier-usage claims.","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z]{2}$"}}],"responses":{"200":{"description":"State observations split into exact dossier relations and manufacturer-level context.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentStateEnvelope"}}}},"404":{"description":"Catalog disabled or state equipment context not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/equipment-systems/{slug}":{"get":{"tags":["Equipment"],"operationId":"getEquipmentSystem","summary":"Get one source-linked equipment dossier","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Equipment system, component/version/change/finding/power/deployment records, and source manifest.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentSystemDetailEnvelope"}}}},"404":{"description":"Pilot disabled or equipment system not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/equipment-systems/{slug}/jurisdictions":{"get":{"tags":["Equipment"],"operationId":"listEquipmentSystemJurisdictions","summary":"List sourced jurisdiction context for one equipment dossier","description":"Product-family matches and manufacturer-only context are separate evidence bands. Manufacturer context does not establish deployment of the dossier's exact model, components, firmware, or certified configuration.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence","in":"query","required":false,"schema":{"type":"string","enum":["device_family","manufacturer_context"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Paginated source-linked jurisdiction observations and the source packages used by the returned rows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentUsageEnvelope"}}}},"400":{"description":"Unsupported evidence band.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Catalog disabled or equipment system not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/v1/openapi":{"get":{"tags":["Platform"],"operationId":"getOpenApiDocument","summary":"Get this OpenAPI 3.1 document","responses":{"200":{"description":"OpenAPI document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/district-compactness":{"get":{"tags":["Districts"],"operationId":"listDistrictCompactness","summary":"List advisory compactness measurements for official 2024 district plans","description":"Returns Polsby-Popper and convex-hull ratios plus detailed-versus-1:500,000 resolution sensitivity. These shape measurements do not score gerrymandering, intent, legality, representation, or election integrity.","parameters":[{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"geography","in":"query","schema":{"type":"string","enum":["congressional","state_upper","state_lower"]}},{"name":"stability","in":"query","schema":{"type":"string","enum":["stable","resolution_sensitive"]}},{"name":"q","in":"query","schema":{"type":"string","maxLength":100}},{"name":"sort","in":"query","schema":{"type":"string","enum":["polsby_asc","polsby_desc","hull_asc","resolution_difference_desc","state_asc"],"default":"polsby_asc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Plan-vintage district compactness rows with methodology and result-join status."},"400":{"description":"The request could not be parsed or validated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/results":{"get":{"tags":["Platform"],"summary":"List current contest result rows for one state","responses":{"200":{"description":"Result rows."}}}},"/api/historical-baselines":{"get":{"tags":["Platform"],"summary":"List historical baseline rows for one state","responses":{"200":{"description":"Historical rows."}}}},"/api/sources":{"get":{"tags":["Platform"],"summary":"List source records for one state","responses":{"200":{"description":"Source records."}}}},"/api/completeness":{"get":{"tags":["Platform"],"summary":"List national state completeness summaries","responses":{"200":{"description":"Completeness summaries."}}}}},"components":{"schemas":{"ConnectionEntity":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"label":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"geography":{"type":"string"},"identifiers":{"type":"object","additionalProperties":{"type":"string"}}},"required":["id","label","category","description","geography","identifiers"],"additionalProperties":false},"ConnectionSource":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"authority":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri","pattern":"^https://"},"sourceClass":{"type":"string","enum":["official","issuer","independent","supplemental"]},"publishedOn":{"type":["string","null"],"format":"date"},"eventOn":{"type":["string","null"],"format":"date"}},"required":["id","authority","title","url","sourceClass","publishedOn","eventOn"],"additionalProperties":false},"ConnectionSourceRevision":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"url":{"type":"string","format":"uri","pattern":"^https://"},"retrievedAt":{"type":["string","null"],"format":"date-time"},"publishedOn":{"type":["string","null"],"format":"date"},"capturedAt":{"type":"string","format":"date-time"},"captureMethod":{"type":"string","enum":["http","retained_local","researcher_copy"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"byteLength":{"type":"integer","minimum":1,"maximum":20971520},"contentType":{"type":"string","enum":["application/pdf","text/html","text/plain","application/json"]},"completeness":{"type":"string","enum":["complete","partial"]}},"required":["id","sourceId","url","retrievedAt","publishedOn","captureMethod","sha256","byteLength","contentType","completeness"],"additionalProperties":false},"ConnectionEvidence":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"claimId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"sourceId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"revisionId":{"type":["string","null"],"pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"relation":{"type":"string","enum":["supports","contradicts","context"]},"locator":{"type":"object","properties":{"page":{"type":["integer","null"],"minimum":1},"section":{"type":"string"},"pointer":{"type":["string","null"]}},"required":["page","section","pointer"],"additionalProperties":false},"excerpt":{"type":"string","maxLength":1600},"attribution":{"type":"string","enum":["official_record","issuer_statement","independent_reporting","supplemental"]}},"required":["id","claimId","sourceId","revisionId","relation","locator","excerpt","attribution"],"additionalProperties":false},"ConnectionClaim":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"from":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"to":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"label":{"type":"string"},"kind":{"type":"string","enum":["results","survey","ownership","role","technology","contract","inventory"]},"view":{"type":"string","enum":["reporting","ownership","technology"]},"geography":{"type":"string"},"establishes":{"type":"string"},"limitation":{"type":"string"},"dated":{"type":"string"},"observedOn":{"type":["string","null"],"format":"date"},"effectiveFrom":{"type":["string","null"],"format":"date"},"effectiveTo":{"type":["string","null"],"format":"date"},"scope":{"type":"string","enum":["documented","certified","procured","fielded"]},"ownership":{"type":["object","null"],"properties":{"economicPct":{"type":["number","null"],"minimum":0,"maximum":100},"votingPct":{"type":["number","null"],"minimum":0,"maximum":100}},"required":["economicPct","votingPct"],"additionalProperties":false}},"required":["id","from","to","label","kind","view","geography","establishes","limitation","dated","observedOn","effectiveFrom","effectiveTo","scope","ownership"],"additionalProperties":false},"ConnectionContract":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"claimId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"awardId":{"type":"string"},"buyer":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"supplier":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"scope":{"type":"string"},"currency":{"const":"USD"},"ceiling":{"type":["number","null"],"minimum":0},"obligated":{"type":["number","null"],"minimum":0},"spent":{"type":["number","null"],"minimum":0},"signedOn":{"type":["string","null"],"format":"date"},"startsOn":{"type":["string","null"],"format":"date"},"endsOn":{"type":["string","null"],"format":"date"},"amendment":{"type":"string"}},"required":["id","claimId","awardId","buyer","supplier","scope","currency","ceiling","obligated","spent","signedOn","startsOn","endsOn","amendment"],"additionalProperties":false},"ConnectionQuestion":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"},"title":{"type":"string"},"question":{"type":"string"},"needed":{"type":"string"},"sourceIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"}},"status":{"type":"string","enum":["open","researching","awaiting_records","documented","contradicted","inconclusive"]},"geography":{"type":"string"},"finding":{"type":"string"},"resolutionClaimIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,119}$"}}},"required":["id","title","question","needed","sourceIds","status","geography","finding","resolutionClaimIds"],"additionalProperties":false},"ConnectionsDocument":{"type":"object","properties":{"schemaVersion":{"const":2},"releaseId":{"type":"string"},"reviewedOn":{"type":"string","format":"date"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionEntity"}},"claims":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionClaim"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionSource"}},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionSourceRevision"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionEvidence"}},"contracts":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionContract"}},"questions":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionQuestion"}}},"required":["schemaVersion","releaseId","reviewedOn","entities","claims","sources","revisions","evidence","contracts","questions"],"additionalProperties":false},"ConnectionsEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ConnectionsDocument"},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"properties":{"schemaVersion":{"const":"connections/2"}}}]}},"required":["data","meta"],"additionalProperties":false},"ConnectionSourceRevisionData":{"type":"object","properties":{"revision":{"$ref":"#/components/schemas/ConnectionSourceRevision"},"source":{"$ref":"#/components/schemas/ConnectionSource"},"passages":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionEvidence"}}},"required":["revision","source","passages"],"additionalProperties":false},"ConnectionSourceRevisionEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ConnectionSourceRevisionData"},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"properties":{"schemaVersion":{"const":"connections/2"}}}]}},"required":["data","meta"],"additionalProperties":false},"ResultCandidateLineage":{"type":"object","properties":{"candidate":{"type":"string"},"votes":{"type":"integer","minimum":0},"source":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri","pattern":"^https://"},"authority":{"type":"string"},"sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"reviewStatus":{"type":"string","enum":["reviewed_revision","review_not_established"]}},"required":["id","url","authority","sha256","reviewStatus"],"additionalProperties":false},"import":{"type":"object","properties":{"id":{"type":["string","null"]},"status":{"type":["string","null"]},"stagingSha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"parser":{"type":["string","null"]},"parserCodeSha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"configCanonicalSha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"}},"required":["id","status","stagingSha256","parser","parserCodeSha256","configCanonicalSha256"],"additionalProperties":false},"locator":{"type":["object","null"],"description":"Whitelisted county/race/total pointer and candidate contributions, when stored.","additionalProperties":true},"checks":{"type":"object","properties":{"officialSource":{"type":"boolean"},"sourceDigestMatches":{"type":"boolean"},"sourceReviewed":{"type":"boolean"},"aggregationMatches":{"type":"boolean"},"rawSourceMatches":{"type":"boolean"},"importManifestRecorded":{"type":"boolean"},"display":{"const":"not_checked"}},"required":["officialSource","sourceDigestMatches","sourceReviewed","aggregationMatches","rawSourceMatches","importManifestRecorded","display"],"additionalProperties":false},"status":{"type":"string","enum":["source_and_import_matched","incomplete"]}},"required":["candidate","votes","source","import","locator","checks","status"],"additionalProperties":false},"ResultLineageData":{"type":"object","properties":{"selection":{"type":"object","properties":{"state":{"const":"TX"},"year":{"const":"2024"},"office":{"const":"president"},"level":{"const":"county"},"jurisdictionCode":{"type":"string"}},"required":["state","year","office","level","jurisdictionCode"],"additionalProperties":false},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/ResultCandidateLineage"}},"displayVerification":{"const":"not_checked"},"caveat":{"type":"string"}},"required":["selection","candidates","displayVerification","caveat"],"additionalProperties":false},"ResultLineageEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ResultLineageData"},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"properties":{"schemaVersion":{"const":"result-lineage/1"}}}]}},"required":["data","meta"],"additionalProperties":false},"EnvelopeMeta":{"type":"object","required":["generatedAt","source","releaseId","schemaVersion"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"source":{"type":"string"},"schemaVersion":{"type":"string","example":"1.0.0"},"releaseId":{"type":["string","null"],"example":"2026-07-11-national-county-v1"},"dataRevision":{"type":["string","null"],"description":"Stored result-data revision; null when a stable revision was not established."},"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0}},"additionalProperties":true},"ErrorEnvelope":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"null"},"error":{"oneOf":[{"type":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"additionalProperties":false}]},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}},"additionalProperties":false},"ConfidenceLevel":{"type":"string","enum":["exact","derived","partial","proxy","non_geographic","unavailable"]},"DataConfidence":{"type":"object","required":["level","label","shortLabel","description","caveat"],"properties":{"level":{"$ref":"#/components/schemas/ConfidenceLevel"},"label":{"type":"string"},"shortLabel":{"type":"string"},"description":{"type":"string"},"caveat":{"type":["string","null"]}},"additionalProperties":false},"TurnoutSnapshot":{"type":["object","null"],"properties":{"ballotsCast":{"type":["integer","null"]},"registeredVoters":{"type":["integer","null"]},"turnoutPct":{"type":["number","null"]},"denominatorNote":{"type":["string","null"]}},"additionalProperties":true},"ElectionSnapshot":{"type":"object","required":["year","demCandidate","repCandidate","demVotes","repVotes","otherVotes","totalVotes","winner","demMarginVotes","demMarginPct","confidence","sourceId"],"properties":{"year":{"type":"integer","enum":[2016,2020,2024]},"demCandidate":{"type":"string"},"repCandidate":{"type":"string"},"demVotes":{"type":["integer","null"]},"repVotes":{"type":["integer","null"]},"otherVotes":{"type":["integer","null"]},"totalVotes":{"type":["integer","null"]},"winner":{"type":"string","enum":["blue","red","tie","unavailable"]},"demMarginVotes":{"type":["integer","null"]},"demMarginPct":{"type":["number","null"]},"demSharePct":{"type":["number","null"]},"repSharePct":{"type":["number","null"]},"confidence":{"$ref":"#/components/schemas/ConfidenceLevel"},"caveat":{"type":["string","null"]},"sourceId":{"type":"string"},"sourceAuthority":{"type":["string","null"]},"sourceConfidence":{"type":["string","null"]},"sourceUrl":{"type":["string","null"],"format":"uri"},"turnout":{"$ref":"#/components/schemas/TurnoutSnapshot"}},"additionalProperties":false},"CountyComparisonRow":{"type":"object","required":["state","fips","jurisdictionTag","county","direction","from","to","marginSwingPct","totalVoteChange","totalVoteChangePct","confidence","caveat"],"properties":{"state":{"type":"string","pattern":"^[A-Z]{2}$"},"fips":{"type":"string","pattern":"^[0-9]{5}$"},"jurisdictionTag":{"type":"string","pattern":"^county:[0-9]{5}$"},"county":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"direction":{"type":"string","enum":["red_to_blue","blue_to_red","no_flip"]},"from":{"$ref":"#/components/schemas/ElectionSnapshot"},"to":{"$ref":"#/components/schemas/ElectionSnapshot"},"marginSwingPct":{"type":["number","null"]},"totalVoteChange":{"type":["integer","null"]},"totalVoteChangePct":{"type":["number","null"]},"turnoutBallotsChange":{"type":["integer","null"]},"turnoutBallotsChangePct":{"type":["number","null"]},"confidence":{"$ref":"#/components/schemas/ConfidenceLevel"},"caveat":{"type":["string","null"]}},"additionalProperties":false},"ComparisonEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CountyComparisonRow"}},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"type":"object","required":["coverage","filters","pagination","summary"],"properties":{"coverage":{"type":"object","additionalProperties":true},"filters":{"type":"object","additionalProperties":true},"pagination":{"type":"object","required":["hasMore","limit","offset","returned","total"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"returned":{"type":"integer"},"total":{"type":"integer"}}},"summary":{"type":"object","additionalProperties":{"type":"integer"}}}}]}}},"CanonicalJurisdiction":{"type":"object","required":["state","fips","jurisdictionTag","displayName","aliases","level","geoid"],"properties":{"state":{"type":"string","pattern":"^[A-Z]{2}$"},"fips":{"type":"string","pattern":"^[0-9]{5}$"},"geoid":{"type":"string","pattern":"^[0-9]{5}$"},"jurisdictionTag":{"type":"string","pattern":"^county:[0-9]{5}$"},"displayName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"level":{"type":"string"},"geometryKey":{"type":"string"},"source":{"type":"string"},"caveat":{"type":"string"}},"additionalProperties":false},"JurisdictionEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CanonicalJurisdiction"}},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"type":"object","required":["hasMore","limit","offset","total"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}]}}},"ConfidenceDefinition":{"type":"object","required":["level","label","shortLabel","description"],"properties":{"level":{"$ref":"#/components/schemas/ConfidenceLevel"},"label":{"type":"string"},"shortLabel":{"type":"string"},"description":{"type":"string"}},"additionalProperties":false},"ConfidenceDefinitionEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","minItems":6,"maxItems":6,"items":{"$ref":"#/components/schemas/ConfidenceDefinition"}},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"CountyHistoricalContext":{"type":"object","required":["caveat","effectiveDate","formerFips","formerName","relationship","sourceUrl","successorFips"],"properties":{"caveat":{"type":"string"},"effectiveDate":{"type":"string","format":"date"},"formerFips":{"type":"string","pattern":"^[0-9]{5}$"},"formerName":{"type":"string"},"relationship":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"successorFips":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^[0-9]{5}$"}}},"additionalProperties":false},"CountySearchMatch":{"type":"object","required":["state","stateName","fips","jurisdictionTag","displayName","aliases","matchedOn","matchedValue","score"],"properties":{"state":{"type":"string","pattern":"^[A-Z]{2}$"},"stateName":{"type":"string"},"fips":{"type":"string","pattern":"^[0-9]{5}$"},"jurisdictionTag":{"type":"string","pattern":"^county:[0-9]{5}$"},"displayName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"historicalContext":{"$ref":"#/components/schemas/CountyHistoricalContext"},"matchedOn":{"type":"string","enum":["alias","fips","historical_fips","historical_name","name","state"]},"matchedValue":{"type":"string"},"score":{"type":"integer"},"caveat":{"type":"string"}},"additionalProperties":true},"CountySearchEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CountySearchMatch"}},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"type":"object","required":["limit","offset","total"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}]}}},"CountyElectionHistory":{"type":"object","required":["year","available","demVotes","repVotes","otherVotes","totalVotes","leader","marginVotes","marginPct","confidence"],"properties":{"year":{"type":"integer","enum":[2016,2020,2024]},"available":{"type":"boolean"},"demVotes":{"type":["integer","null"]},"repVotes":{"type":["integer","null"]},"otherVotes":{"type":["integer","null"]},"totalVotes":{"type":["integer","null"]},"leader":{"type":["string","null"],"enum":["Democratic","Republican","Tie",null]},"marginVotes":{"type":["integer","null"]},"marginPct":{"type":["number","null"]},"confidence":{"$ref":"#/components/schemas/DataConfidence"},"caveats":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"CountyProfile":{"type":"object","required":["state","stateName","fips","jurisdictionTag","displayName","aliases","history","turnout","equipment","voteMethods","advisoryIndicators","sources","confidence","caveats"],"properties":{"state":{"type":"string","pattern":"^[A-Z]{2}$"},"stateName":{"type":"string"},"fips":{"type":"string","pattern":"^[0-9]{5}$"},"jurisdictionTag":{"type":"string","pattern":"^county:[0-9]{5}$"},"displayName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"history":{"type":"array","minItems":3,"maxItems":3,"items":{"$ref":"#/components/schemas/CountyElectionHistory"}},"turnout":{"type":"object","additionalProperties":true},"equipment":{"type":"array","items":{"type":"object","additionalProperties":true}},"voteMethods":{"type":"array","items":{"type":"object","additionalProperties":true}},"advisoryIndicators":{"type":"array","items":{"type":"object","additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"confidence":{"$ref":"#/components/schemas/DataConfidence"},"caveats":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"CountyProfileEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/CountyProfile"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"EquipmentSystemSummary":{"type":"object","required":["slug","displayName","manufacturer","systemName","systemVersion","deviceName","deviceRole","status","summary","certification","claimRevision","editorialState","coverage"],"properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"manufacturer":{"type":"string"},"systemName":{"type":"string"},"systemVersion":{"type":"string"},"deviceName":{"type":"string"},"deviceRole":{"type":"string"},"status":{"type":"string","enum":["pilot"]},"summary":{"type":"string"},"certification":{"type":"object","additionalProperties":true},"claimRevision":{"type":"integer","minimum":1},"editorialState":{"type":"string","enum":["approved","published"]},"coverage":{"type":"object","additionalProperties":{"type":"integer"}}},"additionalProperties":true},"EquipmentSourceRevision":{"type":"object","required":["id","localArtifact","sha256","byteLength","publishedOn","retrievedOn","retrievedAt","retrievalPrecision","resolvedUrl","http","supersedesRevisionId","contentStatus","pageOrSection","archiveStatus"],"properties":{"id":{"type":"string"},"localArtifact":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"byteLength":{"type":"integer","minimum":1},"publishedOn":{"type":["string","null"],"format":"date"},"retrievedOn":{"type":"string","format":"date"},"retrievedAt":{"type":["string","null"],"format":"date-time"},"retrievalPrecision":{"type":"string","enum":["date","timestamp"]},"resolvedUrl":{"type":"string","format":"uri"},"http":{"type":"object","additionalProperties":{"type":["string","null"]}},"supersedesRevisionId":{"type":["string","null"]},"contentStatus":{"type":"string","enum":["baseline","content_changed"]},"pageOrSection":{"type":"string"},"archiveStatus":{"type":"string","enum":["verified","pending_review","rejected"]}},"additionalProperties":false},"EquipmentSourceRevisionComparison":{"type":"object","required":["id","fromRevisionId","toRevisionId","detectedAt","kind","machineSummary","editorialImpact","reviewState"],"properties":{"id":{"type":"string"},"fromRevisionId":{"type":"string"},"toRevisionId":{"type":"string"},"detectedAt":{"type":"string","format":"date-time"},"kind":{"type":"string","enum":["unchanged","metadata_changed","content_changed","unavailable","retrieval_error"]},"machineSummary":{"type":"string"},"editorialImpact":{"type":"string","enum":["none","requires_claim_review"]},"reviewState":{"type":"string","enum":["pending","approved","rejected"]},"reviewNote":{"type":["string","null"]},"reviewedAt":{"type":["string","null"],"format":"date-time"},"reviewedBy":{"type":["string","null"]}},"additionalProperties":false},"EquipmentSource":{"type":"object","required":["id","publisher","authorityLevel","title","url","canonicalUrl","localArtifact","sha256","documentType","retrievedOn","pageOrSection","caveat","currentReviewedRevisionId","latestRetrievedRevisionId","revisions","revisionComparisons"],"properties":{"id":{"type":"string"},"publisher":{"type":"string"},"authorityLevel":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"canonicalUrl":{"type":"string","format":"uri"},"localArtifact":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"documentType":{"type":"string"},"publishedOn":{"type":["string","null"],"format":"date"},"retrievedOn":{"type":"string","format":"date"},"pageOrSection":{"type":"string"},"caveat":{"type":"string"},"currentReviewedRevisionId":{"type":"string"},"latestRetrievedRevisionId":{"type":"string"},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentSourceRevision"}},"revisionComparisons":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentSourceRevisionComparison"}}},"additionalProperties":false},"EquipmentSystem":{"allOf":[{"$ref":"#/components/schemas/EquipmentSystemSummary"},{"type":"object","required":["components","versionObservations","configurationChanges","findings","power","deployments","scene","caveats","sourceIds","sourceRevisionIds"],"properties":{"components":{"type":"array","items":{"type":"object","additionalProperties":true}},"versionObservations":{"type":"array","items":{"type":"object","additionalProperties":true}},"configurationChanges":{"type":"array","items":{"type":"object","additionalProperties":true}},"findings":{"type":"array","items":{"type":"object","additionalProperties":true}},"power":{"type":"array","items":{"type":"object","additionalProperties":true}},"deployments":{"type":"array","items":{"type":"object","additionalProperties":true}},"scene":{"type":"object","additionalProperties":true},"caveats":{"type":"array","items":{"type":"string"}},"sourceIds":{"type":"array","items":{"type":"string"}},"sourceRevisionIds":{"type":"array","items":{"type":"string"}}}}]},"EquipmentSystemListEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentSystemSummary"}},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"type":"object","properties":{"schemaVersion":{"type":"string","example":"2.1.0"}}}]}}},"EquipmentSystemDetailEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["system","sources"],"properties":{"system":{"$ref":"#/components/schemas/EquipmentSystem"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentSource"}}}},"meta":{"allOf":[{"$ref":"#/components/schemas/EnvelopeMeta"},{"type":"object","properties":{"schemaVersion":{"type":"string","example":"2.1.0"}}}]}}},"EquipmentUsageRelationTarget":{"oneOf":[{"type":"object","required":["kind","slug"],"properties":{"kind":{"type":"string","const":"equipment_system"},"slug":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["kind","id","displayName"],"properties":{"kind":{"type":"string","const":"manufacturer"},"id":{"type":"string"},"displayName":{"type":"string"}},"additionalProperties":false}]},"EquipmentUsageRelation":{"type":"object","required":["id","evidenceKind","target","matchReason"],"properties":{"id":{"type":"string"},"evidenceKind":{"type":"string","enum":["device_family","manufacturer_context"]},"target":{"$ref":"#/components/schemas/EquipmentUsageRelationTarget"},"matchReason":{"type":"string"}},"additionalProperties":false},"EquipmentManufacturerContext":{"type":"object","required":["manufacturer","state","totalRecords","sourceIds","reportedSystemNames","reportedVendors","relatedDossierSlugs","caveat"],"properties":{"manufacturer":{"$ref":"#/components/schemas/EquipmentUsageRelationTarget"},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"totalRecords":{"type":"integer","minimum":1},"sourceIds":{"type":"array","items":{"type":"string"}},"reportedSystemNames":{"type":"array","items":{"type":"string"}},"reportedVendors":{"type":"array","items":{"type":"string"}},"relatedDossierSlugs":{"type":"array","items":{"type":"string"}},"caveat":{"type":"string"}},"additionalProperties":false},"EquipmentStateEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["state","totalObservations","exactProductFamilySystems","manufacturerContexts","sourceIds","caveat"],"properties":{"state":{"type":"object","required":["code","name"],"properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"name":{"type":"string"}},"additionalProperties":false},"totalObservations":{"type":"integer","minimum":1},"exactProductFamilySystems":{"type":"array","items":{"type":"object","additionalProperties":true}},"manufacturerContexts":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentManufacturerContext"}},"sourceIds":{"type":"array","items":{"type":"string"}},"caveat":{"type":"string"}},"additionalProperties":false},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"EquipmentComparisonEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["systems"],"properties":{"systems":{"type":"array","minItems":2,"maxItems":3,"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"EquipmentUsageRecord":{"type":"object","required":["id","slug","evidenceKind","matchReason","relation","relationScope","relationTarget","requestedDossierContext","state","electionYear","jurisdictionCode","jurisdictionName","jurisdictionLevel","jurisdictionTag","vendor","systemName","equipmentType","sourceId","map"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"evidenceKind":{"type":"string","enum":["device_family","manufacturer_context"]},"matchReason":{"type":"string"},"relation":{"$ref":"#/components/schemas/EquipmentUsageRelation"},"relationScope":{"type":"string","enum":["exact_product_family","manufacturer_context"]},"relationTarget":{"$ref":"#/components/schemas/EquipmentUsageRelationTarget"},"requestedDossierContext":{"oneOf":[{"type":"null"},{"type":"object","required":["slug","relationship"],"properties":{"slug":{"type":"string"},"relationship":{"type":"string","const":"same_manufacturer_not_exact_deployment"}},"additionalProperties":false}]},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"electionYear":{"type":"integer","enum":[2024]},"jurisdictionCode":{"type":"string"},"jurisdictionName":{"type":"string"},"jurisdictionLevel":{"type":"string"},"jurisdictionTag":{"type":["string","null"]},"vendor":{"type":"string"},"systemName":{"type":"string"},"equipmentType":{"type":"string"},"sourceId":{"type":"string"},"map":{"type":"object","required":["scope","href","label","caveat"],"properties":{"scope":{"type":"string","enum":["jurisdiction","state","unavailable"]},"href":{"type":["string","null"]},"label":{"type":["string","null"]},"caveat":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false},"EquipmentUsageEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["system","summary","evidenceKind","relation","requestedDossierContext","records","sources","total","limit","offset"],"properties":{"system":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"evidenceKind":{"type":"string","enum":["device_family","manufacturer_context"]},"relation":{"type":"object","required":["evidenceKind","target"],"properties":{"evidenceKind":{"type":"string","enum":["device_family","manufacturer_context"]},"target":{"$ref":"#/components/schemas/EquipmentUsageRelationTarget"}},"additionalProperties":false},"requestedDossierContext":{"oneOf":[{"type":"null"},{"type":"object","additionalProperties":true}]},"records":{"type":"array","items":{"$ref":"#/components/schemas/EquipmentUsageRecord"}},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0}}},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"NationalDataRelease":{"type":"object","required":["id","title","summary","product","publishedAt","status","electionYears","dataSha256","archivePath","archiveSha256","coverage","coverageHighlights","changes","knownLimitations","requiredEntries","sourceArtifacts"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"product":{"type":"string","enum":["national_county_results","historical_presidential_results","election_equipment","election_security_incidents"]},"publishedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["available","current","superseded"]},"electionYears":{"type":"array","items":{"type":"integer","enum":[2012,2016,2020,2024]}},"geographyContract":{"type":"string"},"geographyVintage":{"type":"string"},"geographyVintageYear":{"type":"integer"},"historicalGeographyPolicy":{"type":"string"},"dataSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"archivePath":{"type":"string"},"archiveSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"coverage":{"type":"object","additionalProperties":true},"coverageHighlights":{"type":"array","items":{"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"string"}}}},"comparisonSummary":{"type":"object","additionalProperties":true},"changes":{"type":"array","items":{"type":"string"}},"knownLimitations":{"type":"array","items":{"type":"string"}},"requiredEntries":{"type":"array","items":{"type":"string"}},"sourceArtifacts":{"type":"array","items":{"type":"string"}},"primaryDataEntry":{"type":"string"}},"additionalProperties":true},"ReleaseEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/NationalDataRelease"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}},"ReleaseCatalogEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/NationalDataRelease"}},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"}}}}},"externalDocs":{"description":"Civic Result Maps API guide","url":"https://www.civicresultmaps.org/developers"}}