{"openapi":"3.1.0","info":{"title":"One Health Lyme Gap Atlas API","summary":"Governed Atlas analytics, metadata, and provenance","description":"Read-only structured data from the One Health Lyme Gap Atlas.\nOrdinary public reads are anonymous and require no API key.\n\n## Interpretation and reproducibility\nV1 (`/v1`) is the HTTP contract version; the application version is separate.\nRead source, methodology, semantic/release versions, and limitations together.\nSurveillance floors and gap scores are not diagnoses, individual risk estimates,\nor causal claims. Null, zero, suppressed values, and no linked records have\ndistinct meanings. Response time is not publisher freshness.\n\n## Queries and errors\nCanonical collections use `data`, `meta`, and `links`; details use `data`.\nPagination defaults to 100 items (maximum 500). Send opaque `next_page_token`\nas `page_token` with the same filters; null means exhaustion. Tokens bind to\nquery/release and may expire on restart. Current-release observations require\none measure, 1–500 county FIPS IDs, and a year or complete inclusive date range.\nThe default pre-execution logical-result ceiling is 10,000, not truncation.\nOnly the annual 2023 period is currently published; no strata are supported.\n\nErrors use RFC 9457 `application/problem+json` with `request_id` for support.\nCanonical errors carry stable `code` values; legacy Atlas routes retain their\nexisting error semantics (including 422 validation). Respect `Retry-After` on\n429/503. Canonical metadata/observations cache for 60 seconds; supported detail\nresources return ETags and 304 on matching `If-None-Match`. See each operation\nfor legacy cache and export behavior.\n\n## Contract consumers\nFumadocs, `/docs`, and `/redoc` consume the canonical public `openapi.json`\nat `/openapi.json`. Internal product operations are not part of this contract.\nExisting operation IDs remain stable for\ngenerated clients. Breaking public changes require an approved migration and\ndeprecation plan; optional additive fields may appear within V1.\nOnly separately approved ML outputs may be published. Internal conversational\nAI, literature retrieval, account, and feedback product routes are excluded.\n","contact":{"name":"One Health Atlas","url":"https://onehealthatlas.org/"},"version":"0.1.0","x-logo":{"url":"https://api.onehealthatlas.org/docs/summit-compass-north-20261010/favicon-256x256.png","altText":"Atlas"}},"servers":[{"url":"https://api.onehealthatlas.org","description":"Production"}],"paths":{"/v1/atlas/geometry":{"get":{"tags":["atlas"],"summary":"Get county display geometry","description":"Existing generalized CDC/ATSDR SVI 2022 display geometry in EPSG:4326, identified by stable five-digit county FIPS. This resource never returns internal 2025 TIGER/Line analysis polygons used for raster aggregation.","operationId":"geometry_v1_atlas_geometry_get","parameters":[{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}}],"responses":{"200":{"description":"Display GeoJSON, EPSG:4326; immutable TTL 31536000; ETag.","content":{"application/geo+json":{"schema":{"type":"object"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Matching If-None-Match; empty body."}}}},"/v1/atlas/metadata":{"get":{"tags":["atlas"],"summary":"Get Atlas release metadata","description":"Release metadata, source freshness and methodology; dataset_version selects an existing release. Cached publicly for 300 seconds with ETag. ETag is informational here; this route does not implement conditional 304.","operationId":"metadata_v1_atlas_metadata_get","parameters":[{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AtlasMetadata"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/atlas/ranking.csv":{"get":{"tags":["atlas"],"summary":"Download filtered county rankings","description":"Filtered CSV attachment for current county rankings. Existing state, text and evidence filters and score settings apply; no pagination. This route does not declare a public cache TTL.","operationId":"ranking_csv_v1_atlas_ranking_csv_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^(ALL|[A-Z]{2})$","default":"ALL","title":"State"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100,"default":"","title":"Q"}},{"name":"evidence","in":"query","required":false,"schema":{"enum":["all","ecological","human","complete"],"type":"string","default":"all","title":"Evidence"}},{"name":"ecological_share","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":85,"minimum":40,"default":65,"title":"Ecological Share"}},{"name":"low_incidence_breakpoint","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":5,"default":10,"title":"Low Incidence Breakpoint"}},{"name":"missing_human_weakness","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":90,"minimum":40,"default":75,"title":"Missing Human Weakness"}}],"responses":{"200":{"description":"CSV attachment.","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/atlas/scores":{"get":{"tags":["atlas"],"summary":"Get county gap scores","description":"Existing surveillance-gap scores and settings for an optional dataset_version. Scores are not individual risk estimates or diagnoses. Public cache TTL 300 seconds with informational ETag; no conditional 304.","operationId":"scores_v1_atlas_scores_get","parameters":[{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}},{"name":"ecological_share","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":85,"minimum":40,"default":65,"title":"Ecological Share"}},{"name":"low_incidence_breakpoint","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":5,"default":10,"title":"Low Incidence Breakpoint"}},{"name":"missing_human_weakness","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":90,"minimum":40,"default":75,"title":"Missing Human Weakness"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreCollection"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/counties/{fips}":{"get":{"tags":["counties"],"summary":"Get county analytics and provenance","description":"Five-digit county FIPS with leading zeros retained. Includes release/source metadata and limitations. Optional dataset_version and score settings retain existing meanings. Public cache TTL 300 seconds with informational ETag; no conditional 304.","operationId":"county_v1_counties__fips__get","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Fips"}},{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}},{"name":"ecological_share","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":85,"minimum":40,"default":65,"title":"Ecological Share"}},{"name":"low_incidence_breakpoint","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":5,"default":10,"title":"Low Incidence Breakpoint"}},{"name":"missing_human_weakness","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":90,"minimum":40,"default":75,"title":"Missing Human Weakness"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountyDetail"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/counties/{fips}/report.pdf":{"get":{"tags":["counties"],"summary":"Download a county report","description":"PDF attachment using the immutable county-v1 registered template by default. Optional dataset_version and score settings bind report inputs. Opt-in county-v2 requires dataset_version, period_start, period_end and repeated measure_id (1–20, repeated or comma-separated); reads canonical evidence, lineage, value states and limitations. Missing or mismatched provenance returns 503; unknown observations return 404. V1 rejects observation selectors with 422. V2 responses use no-store and revalidate authoritative context before cache/304. ETag/If-None-Match supports 304; V1 public cache TTL 300 seconds with revalidation. Unknown templates return 422; resource limits 413; renderer failure/timeout 503.","operationId":"county_report_pdf_v1_counties__fips__report_pdf_get","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Fips"}},{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}},{"name":"period_start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Exact inclusive observation start for county-v2.","title":"Period Start"},"description":"Exact inclusive observation start for county-v2."},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Exact inclusive observation end for county-v2.","title":"Period End"},"description":"Exact inclusive observation end for county-v2."},{"name":"measure_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":20},{"type":"null"}],"description":"1–20 measure IDs; repeated or comma-separated for county-v2.","title":"Measure Id"},"description":"1–20 measure IDs; repeated or comma-separated for county-v2."},{"name":"template","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]+-v\\d+$","default":"county-v1","title":"Template"}},{"name":"ecological_share","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":85,"minimum":40,"default":65,"title":"Ecological Share"}},{"name":"low_incidence_breakpoint","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":5,"default":10,"title":"Low Incidence Breakpoint"}},{"name":"missing_human_weakness","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":90,"minimum":40,"default":75,"title":"Missing Human Weakness"}}],"responses":{"200":{"description":"PDF attachment.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Matching If-None-Match; empty body."},"400":{"description":"Narrow the observation period.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"Narrow the observation period.","instance":"/v1/observations","request_id":"example-request-id","code":"QUERY_TOO_BROAD"}}}}}},"413":{"description":"The report exceeds configured resource limits.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"The report exceeds configured resource limits.","instance":"/v1/observations","request_id":"example-request-id"}}}}}}}}},"/v1/counties/{fips}/tier1-surveillance-priority":{"get":{"tags":["counties"],"summary":"Get persisted Tier 1 model-assisted surveillance review priority","description":"Returns the approved persisted county result from the current Tier 1 batch. This is surveillance review priority, not Lyme disease risk, predicted incidence, probability, clinical risk, or diagnosis. LOW is a scored tier; evidence sufficiency is separate. Percentile is relative to the scored batch and population. A county without a persisted result returns 404; an unavailable current view or malformed result returns 503. Public cache TTL 60 seconds; generated_at_utc is the model batch time, not request time.","operationId":"county_tier1_surveillance_priority_get","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Fips"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tier1CountyPriority"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/counties/{fips}/tier1-surveillance-priority/availability":{"get":{"tags":["counties"],"summary":"Get Tier 1 result availability and persisted data","description":"Additive availability contract for current supported county geographies. A successful lookup returns AVAILABLE with the exact persisted result, or UNAVAILABLE with reason NO_PUBLISHED_MODEL and null data after the current geography release and Tier 1 projection have both been read successfully. geography_release_id identifies the release used to validate the FIPS. This endpoint does not turn null into zero or synthesize model output. NOT_ESTIMABLE is a persisted result state and is distinct from no published model result. Malformed FIPS returns 422; an identity outside the current geography release returns typed 404; dependency or malformed-data failures return 503. Public cache TTL 60 seconds.","operationId":"county_tier1_surveillance_priority_availability_get","parameters":[{"name":"fips","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Fips"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tier1CountyPriorityAvailability"}}}},"404":{"description":"County is not in the current geography release.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County is not in the current geography release.","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/geographies/{geography_type}/{geography_id}":{"get":{"tags":["geographies"],"summary":"Get geography identity (delivery pending)","description":"Validated county/state FIPS identity; currently returns 503 CANONICAL_DATA_UNAVAILABLE. No geometry is returned.","operationId":"geography_v1_geographies__geography_type___geography_id__get","parameters":[{"name":"geography_type","in":"path","required":true,"schema":{"$ref":"#/components/schemas/GeographyType"}},{"name":"geography_id","in":"path","required":true,"schema":{"type":"string","title":"Geography Id"}}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceEnvelope_Geography_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Canonical data delivery is not yet available.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Canonical data delivery is not yet available.","instance":"/v1/observations","request_id":"example-request-id","code":"CANONICAL_DATA_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/indicators":{"get":{"tags":["discovery"],"summary":"Discover indicators","description":"Current-release discovery with optional documented filters. page_size defaults to 100 (maximum 500); reuse opaque page_token with the same filters and release. A null next_page_token ends traversal. Cache-Control: public, max-age=60, must-revalidate.","operationId":"indicators_v1_indicators_get","parameters":[{"name":"indicator_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indicator Id"}},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"description":"Items per page; defaults to 100, configured maximum at most 500.","examples":[100],"title":"Page Size"},"description":"Items per page; defaults to 100, configured maximum at most 500."},{"name":"page_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque next_page_token; retain query filters and release.","title":"Page Token"},"description":"Opaque next_page_token; retain query filters and release."}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnvelope_Indicator_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/indicators/{indicator_id}":{"get":{"tags":["discovery"],"summary":"Get an indicator","description":"Resolve the exact governed public resource ID in the current release. Unknown IDs return 404 RESOURCE_NOT_FOUND. Preserve versions and limitations; null metadata is not inferred. Cache-Control: public, max-age=60, must-revalidate; ETag with matching If-None-Match returns an empty 304.","operationId":"indicator_v1_indicators__indicator_id__get","parameters":[{"name":"indicator_id","in":"path","required":true,"schema":{"type":"string","title":"Indicator Id"}}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceEnvelope_Indicator_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Not modified. ETag matches If-None-Match; empty response body."}}}},"/v1/measures":{"get":{"tags":["discovery"],"summary":"Discover measures","description":"Current-release discovery with optional documented filters. page_size defaults to 100 (maximum 500); reuse opaque page_token with the same filters and release. A null next_page_token ends traversal. Cache-Control: public, max-age=60, must-revalidate.","operationId":"measures_v1_measures_get","parameters":[{"name":"measure_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measure Id"}},{"name":"indicator_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indicator Id"}},{"name":"geography_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geography Type"}},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"description":"Items per page; defaults to 100, configured maximum at most 500.","examples":[100],"title":"Page Size"},"description":"Items per page; defaults to 100, configured maximum at most 500."},{"name":"page_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque next_page_token; retain query filters and release.","title":"Page Token"},"description":"Opaque next_page_token; retain query filters and release."}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnvelope_Measure_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/measures/{measure_id}":{"get":{"tags":["discovery"],"summary":"Get a measure","description":"Resolve the exact governed public resource ID in the current release. Unknown IDs return 404 RESOURCE_NOT_FOUND. Preserve versions and limitations; null metadata is not inferred. Cache-Control: public, max-age=60, must-revalidate; ETag with matching If-None-Match returns an empty 304.","operationId":"measure_v1_measures__measure_id__get","parameters":[{"name":"measure_id","in":"path","required":true,"schema":{"type":"string","title":"Measure Id"}}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceEnvelope_Measure_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Not modified. ETag matches If-None-Match; empty response body."}}}},"/v1/methodologies/{methodology_id}":{"get":{"tags":["provenance"],"summary":"Get a methodology","description":"Resolve the exact governed public resource ID in the current release. Unknown IDs return 404 RESOURCE_NOT_FOUND. Preserve versions and limitations; null metadata is not inferred. Cache-Control: public, max-age=60, must-revalidate; ETag with matching If-None-Match returns an empty 304.","operationId":"methodology_v1_methodologies__methodology_id__get","parameters":[{"name":"methodology_id","in":"path","required":true,"schema":{"type":"string","title":"Methodology Id"}}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceEnvelope_Methodology_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Not modified. ETag matches If-None-Match; empty response body."}}}},"/v1/observations":{"get":{"tags":["observations"],"summary":"Query county observations","description":"Current published county observations only. Ordered by measure ID, county FIPS, period start, and observation ID. Opaque page tokens bind to filters and release. Annual surveillance uses 2023. Separately enabled, reviewed January 2025 environmental measures use labeled daily periods, carry environmental_context coverage, and have no supported strata. Environmental context is descriptive weather, with no causal, disease-risk or ML claim. Surveillance context is optional and requires an admitted Data delivery; normalized_state preserves Data semantics and the publisher value remains value. Separately enabled CDC status uses start_date=end_date=2025-12-31 and CUMULATIVE grain; scapularis_status and burgdorferi_status require exact Data record admission. Annual year and other date ranges return 400 UNSUPPORTED_FILTER before data access. Missing context does not establish absence or temporal comparability. A measure and bounded county/time selection are required; no user sorting or aggregation.","operationId":"observations_v1_observations_get","parameters":[{"name":"measure_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Exact discovery measure ID.","examples":["case_count_floor_2023"],"title":"Measure Id"},"description":"Exact discovery measure ID."},{"name":"geography_type","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GeographyType"}},{"name":"geography_id","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":500,"description":"Repeat for 1-500 county FIPS strings; preserve leading zeros.","examples":[["08001"]],"title":"Geography Id"},"description":"Repeat for 1-500 county FIPS strings; preserve leading zeros."},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1900},{"type":"null"}],"description":"Annual year or complete date range, not both. CDC cumulative status rejects year; use start_date=end_date=2025-12-31.","examples":[2023],"title":"Year"},"description":"Annual year or complete date range, not both. CDC cumulative status rejects year; use start_date=end_date=2025-12-31."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive period start; requires end_date and excludes year.","examples":["2023-01-01"],"title":"Start Date"},"description":"Inclusive period start; requires end_date and excludes year."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive period end; requires start_date and excludes year.","examples":["2023-12-31"],"title":"End Date"},"description":"Inclusive period end; requires start_date and excludes year."},{"name":"stratification","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Current release has no strata; unsupported selections fail explicitly.","title":"Stratification"},"description":"Current release has no strata; unsupported selections fail explicitly."},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"description":"Items per page; defaults to 100, configured maximum at most 500.","examples":[100],"title":"Page Size"},"description":"Items per page; defaults to 100, configured maximum at most 500."},{"name":"page_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque next_page_token; retain query filters and release.","title":"Page Token"},"description":"Opaque next_page_token; retain query filters and release."}],"responses":{"200":{"description":"Bounded current-release observations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnvelope_Observation_"},"examples":{"empty":{"summary":"Illustrative exhausted page; no observations matched","value":{"data":[],"meta":{"next_page_token":null,"response_at":"2026-01-01T00:00:00Z"},"links":{"self":null}}},"missing":{"summary":"Synthetic missing-value example; not a published county result","value":{"data":[{"observation_id":"example-observation","measure_id":"case_count_floor_2023","geography":{"geography_type":"county","geography_id":"08001"},"period_start":"2023-01-01","period_end":"2023-12-31","temporal_grain":"year","value":null,"value_state":"MISSING","unit":"cases","denominator":null,"source_id":"human","methodology_id":null,"methodology_version":"example-transform-v1","semantic_version":"example-semantic-v1","release_id":"example-release","provenance_ref":"example-observation","limitations":["Synthetic documentation example; no measured value is asserted."],"evidence":{"resource_type":"observation","resource_id":"example-observation"}}],"meta":{"next_page_token":null,"response_at":"2026-01-01T00:00:00Z"},"links":{"self":null}}}}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/sources":{"get":{"tags":["provenance"],"summary":"Discover sources","description":"Current-release discovery with optional documented filters. page_size defaults to 100 (maximum 500); reuse opaque page_token with the same filters and release. A null next_page_token ends traversal. Cache-Control: public, max-age=60, must-revalidate.","operationId":"sources_v1_sources_get","parameters":[{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"description":"Items per page; defaults to 100, configured maximum at most 500.","examples":[100],"title":"Page Size"},"description":"Items per page; defaults to 100, configured maximum at most 500."},{"name":"page_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque next_page_token; retain query filters and release.","title":"Page Token"},"description":"Opaque next_page_token; retain query filters and release."}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionEnvelope_Source_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}},"/v1/sources/{source_id}":{"get":{"tags":["provenance"],"summary":"Get a source","description":"Resolve the exact governed public resource ID in the current release. Unknown IDs return 404 RESOURCE_NOT_FOUND. Preserve versions and limitations; null metadata is not inferred. Cache-Control: public, max-age=60, must-revalidate; ETag with matching If-None-Match returns an empty 304.","operationId":"source_v1_sources__source_id__get","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","title":"Source Id"}}],"responses":{"200":{"description":"Successful current-release resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceEnvelope_Source_"}}}},"4XX":{"description":"Canonical client errors use application/problem+json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"400":{"description":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-400","title":"Request failed","status":400,"detail":"INVALID_REQUEST, UNSUPPORTED_FILTER, UNSUPPORTED_STRATIFICATION, or QUERY_TOO_BROAD; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"404":{"description":"RESOURCE_NOT_FOUND; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"RESOURCE_NOT_FOUND; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RESOURCE_NOT_FOUND"}}}}}},"429":{"description":"Rate limited; Retry-After; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limited; Retry-After; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"RATE_LIMITED"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"413":{"description":"GET request body rejected; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"GET request body rejected; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"414":{"description":"Query string too long; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-414","title":"Request failed","status":414,"detail":"Query string too long; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"INVALID_REQUEST"}}}}}},"503":{"description":"Service unavailable; application/problem+json","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Service unavailable; application/problem+json","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Not modified. ETag matches If-None-Match; empty response body."}}}},"/v1/states/{state}/report.pdf":{"get":{"tags":["states"],"summary":"Download a state report","description":"PDF attachment using the immutable state-v1 registered template by default. State is a two-letter code. Optional dataset_version and score settings bind report inputs. ETag/If-None-Match supports 304; public cache TTL 300 seconds with revalidation. Unknown templates return 422; resource limits 413; renderer failure/timeout 503.","operationId":"state_report_pdf_v1_states__state__report_pdf_get","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z]{2}$","title":"State"}},{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}},{"name":"template","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]+-v\\d+$","default":"state-v1","title":"Template"}},{"name":"ecological_share","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":85,"minimum":40,"default":65,"title":"Ecological Share"}},{"name":"low_incidence_breakpoint","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":5,"default":10,"title":"Low Incidence Breakpoint"}},{"name":"missing_human_weakness","in":"query","required":false,"schema":{"type":"integer","multipleOf":5,"maximum":90,"minimum":40,"default":75,"title":"Missing Human Weakness"}}],"responses":{"200":{"description":"PDF attachment.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"304":{"description":"Matching If-None-Match; empty body."},"413":{"description":"The report exceeds configured resource limits.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-413","title":"Request failed","status":413,"detail":"The report exceeds configured resource limits.","instance":"/v1/observations","request_id":"example-request-id"}}}}}}}}},"/v1/states/{state}/review":{"get":{"tags":["states"],"summary":"Review a state's county evidence","description":"Versioned county Review result. Current rules are disabled. Lineage gaps are separate. Public cache TTL is 60 seconds.","operationId":"state_review_v1_states__state__review_get","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z]{2}$","title":"State"}},{"name":"observation_context","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Observation Context"}},{"name":"dataset_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateReview"}}}},"404":{"description":"County or dataset release not found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-404","title":"Request failed","status":404,"detail":"County or dataset release not found.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"422":{"description":"One or more request values are invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-422","title":"Request failed","status":422,"detail":"One or more request values are invalid.","instance":"/v1/observations","request_id":"example-request-id"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-429","title":"Request failed","status":429,"detail":"Rate limit exceeded.","instance":"/v1/observations","request_id":"example-request-id"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}},"503":{"description":"Atlas data service is unavailable.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"examples":{"illustrative":{"summary":"Synthetic error example","value":{"type":"https://carawaylabs.com/problems/http-503","title":"Request failed","status":503,"detail":"Atlas data service is unavailable.","instance":"/v1/observations","request_id":"example-request-id","code":"SERVICE_UNAVAILABLE"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry when supplied by the service.","schema":{"type":"string"}}}}}}}},"tags":[{"name":"discovery","description":"Current-release indicators and measurable variables."},{"name":"observations","description":"Bounded county observations with explicit value states."},{"name":"provenance","description":"Governed source and methodology identities and versions."},{"name":"geographies","description":"Typed geography identity; delivery is not yet available."},{"name":"atlas","description":"Existing release analytics and separate display geometry."},{"name":"counties","description":"Existing county details and versioned PDF reports."},{"name":"states","description":"Existing state PDF reports."}],"externalDocs":{"description":"Atlas documentation and developer guides","url":"https://onehealthatlas.org/docs"},"components":{"schemas":{"ProblemDetails":{"description":"RFC 9457 error. Stable codes are included when the response contract defines one.","properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"instance":{"title":"Instance","type":"string"},"request_id":{"title":"Request Id","type":"string"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"errors":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"default":null,"title":"Errors"}},"required":["type","title","status","detail","instance","request_id"],"title":"ProblemDetails","type":"object"},"AtlasMetadata":{"properties":{"release_id":{"type":"string","title":"Release Id"},"schema_version":{"type":"string","title":"Schema Version"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"loaded_at":{"type":"string","format":"date-time","title":"Loaded At"},"scope":{"type":"string","title":"Scope"},"bundle_sha256":{"type":"string","title":"Bundle Sha256"},"score_defaults":{"additionalProperties":true,"type":"object","title":"Score Defaults"},"methodology_version":{"type":"string","title":"Methodology Version"},"limitations":{"type":"string","title":"Limitations"},"sources":{"items":{"$ref":"#/components/schemas/SourceMetadata"},"type":"array","title":"Sources"},"states":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"States"}},"type":"object","required":["release_id","schema_version","generated_at","loaded_at","scope","bundle_sha256","score_defaults","methodology_version","limitations","sources","states"],"title":"AtlasMetadata"},"SourceMetadata":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"vintage":{"type":"string","title":"Vintage"},"url":{"type":"string","title":"Url"},"note":{"type":"string","title":"Note"}},"type":"object","required":["key","label","vintage","url","note"],"title":"SourceMetadata"},"ScoreCollection":{"properties":{"release_id":{"type":"string","title":"Release Id"},"methodology_version":{"type":"string","title":"Methodology Version"},"settings":{"additionalProperties":{"type":"integer"},"type":"object","title":"Settings"},"counties":{"items":{"$ref":"#/components/schemas/CountyScoreSummary"},"type":"array","title":"Counties"}},"type":"object","required":["release_id","methodology_version","settings","counties"],"title":"ScoreCollection"},"CountyScoreSummary":{"properties":{"fips":{"type":"string","title":"Fips"},"county":{"type":"string","title":"County"},"state":{"type":"string","title":"State"},"state_name":{"type":"string","title":"State Name"},"in_contiguous_tick_scope":{"type":"boolean","title":"In Contiguous Tick Scope"},"human_status":{"type":"string","title":"Human Status"},"tick_status":{"type":"string","title":"Tick Status"},"burgdorferi_status":{"type":"string","title":"Burgdorferi Status"},"evidence_completeness":{"type":"integer","title":"Evidence Completeness"},"score":{"$ref":"#/components/schemas/Score"},"priority":{"type":"string","title":"Priority"},"color":{"type":"string","title":"Color"}},"type":"object","required":["fips","county","state","state_name","in_contiguous_tick_scope","human_status","tick_status","burgdorferi_status","evidence_completeness","score","priority","color"],"title":"CountyScoreSummary"},"Score":{"properties":{"score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Score"},"human_weakness":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Human Weakness"},"ecological":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Ecological"},"community":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Community"},"tick_signal":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Tick Signal"},"pathogen_signal":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Pathogen Signal"},"svi_signal":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Svi Signal"},"access_signal":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Access Signal"},"rural_signal":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Rural Signal"}},"type":"object","required":["score","human_weakness","ecological","community","tick_signal","pathogen_signal","svi_signal","access_signal","rural_signal"],"title":"Score"},"CountyDetail":{"properties":{"fips":{"type":"string","title":"Fips"},"county":{"type":"string","title":"County"},"state":{"type":"string","title":"State"},"state_name":{"type":"string","title":"State Name"},"in_contiguous_tick_scope":{"type":"boolean","title":"In Contiguous Tick Scope"},"human_status":{"type":"string","title":"Human Status"},"tick_status":{"type":"string","title":"Tick Status"},"burgdorferi_status":{"type":"string","title":"Burgdorferi Status"},"evidence_completeness":{"type":"integer","title":"Evidence Completeness"},"score":{"$ref":"#/components/schemas/Score"},"priority":{"type":"string","title":"Priority"},"color":{"type":"string","title":"Color"},"population":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Population"},"case_count_floor_2023":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Case Count Floor 2023"},"incidence_floor_2023":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Incidence Floor 2023"},"state_unallocated_records_2023":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"State Unallocated Records 2023"},"scapularis_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scapularis Status"},"pacificus_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pacificus Status"},"svi_percentile":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Svi Percentile"},"uninsured_percentile":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uninsured Percentile"},"uninsured_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uninsured Percent"},"rucc_2023":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rucc 2023"},"release":{"$ref":"#/components/schemas/AtlasMetadata"}},"type":"object","required":["fips","county","state","state_name","in_contiguous_tick_scope","human_status","tick_status","burgdorferi_status","evidence_completeness","score","priority","color","population","case_count_floor_2023","incidence_floor_2023","state_unallocated_records_2023","scapularis_status","pacificus_status","svi_percentile","uninsured_percentile","uninsured_percent","rucc_2023","release"],"title":"CountyDetail"},"Tier1CountyPriority":{"properties":{"county_fips":{"type":"string","pattern":"^\\d{5}$","title":"County Fips","description":"Five-digit county FIPS for this persisted result."},"priority_tier":{"anyOf":[{"type":"string","enum":["HIGH","MEDIUM","LOW"]},{"type":"null"}],"title":"Priority Tier","description":"HIGH, MEDIUM, or LOW model-assisted surveillance review priority under the named tier policy; not disease risk. Null for NOT_ESTIMABLE."},"priority_percentile":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Priority Percentile","description":"Within-batch relative position among scored counties for this model and inference batch (0-100). Not a probability or comparable across batches, model versions, populations, or tier policies without a separate validation. Null for NOT_ESTIMABLE."},"raw_model_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Raw Model Score","description":"Model-native anomaly score; not a probability, incidence estimate, or clinical/disease risk. Its scale is model-specific and is not comparable across versions without validation. Null for NOT_ESTIMABLE."},"evidence_sufficiency":{"type":"string","enum":["SUFFICIENT","INSUFFICIENT","NOT_ESTIMABLE"],"title":"Evidence Sufficiency","description":"Input-data sufficiency state, not calibrated model confidence. NOT_ESTIMABLE is an abstention with null tier, percentile, and score; SUFFICIENT and INSUFFICIENT both require tier, percentile, and score."},"model_version":{"type":"string","minLength":1,"title":"Model Version","description":"Version of the model that generated this result."},"release_id":{"type":"string","minLength":1,"title":"Release Id","description":"Governed source release for this batch."},"source_commit":{"type":"string","minLength":1,"title":"Source Commit","description":"ML source commit for reproducibility."},"prediction_batch_version":{"type":"string","minLength":1,"title":"Prediction Batch Version","description":"Inference batch identity defining the percentile comparison population."},"tier_policy_version":{"type":"string","minLength":1,"title":"Tier Policy Version","description":"Version of the policy assigning review tiers from scored results."},"generated_at_utc":{"type":"string","format":"date-time","title":"Generated At Utc","description":"UTC batch generation time, not the request time or source observation date."},"reasons":{"items":{"$ref":"#/components/schemas/PriorityReason"},"type":"array","maxItems":3,"title":"Reasons"},"limitation_ref":{"type":"string","minLength":1,"title":"Limitation Ref"}},"type":"object","required":["county_fips","priority_tier","priority_percentile","raw_model_score","evidence_sufficiency","model_version","release_id","source_commit","prediction_batch_version","tier_policy_version","generated_at_utc","reasons","limitation_ref"],"title":"Tier1CountyPriority","description":"Model-assisted surveillance review priority; never disease or clinical risk.","examples":[{"county_fips":"09110","evidence_sufficiency":"SUFFICIENT","generated_at_utc":"2026-10-06T05:34:52Z","limitation_ref":"docs/contracts/tier1-persisted-output-v1.md","model_version":"tier1-statistical-reference-v1","prediction_batch_version":"tier1-review-priority-744b2933bae43718","priority_percentile":98.56824689786828,"priority_tier":"HIGH","raw_model_score":2.0739835966635036,"reasons":[{"code":"PATHOGEN_PRESENT","text":"Publisher reports pathogen Present."}],"release_id":"governed-2026-09-17-unknown-coverage","source_commit":"c6bb8a0f48ede70f332513c1b5843f35988949f1","tier_policy_version":"tier1-review-percentile-v1"}]},"PriorityReason":{"properties":{"code":{"type":"string","minLength":1,"title":"Code"},"text":{"type":"string","minLength":1,"title":"Text"}},"type":"object","required":["code","text"],"title":"PriorityReason"},"Tier1CountyPriorityAvailability":{"properties":{"availability":{"type":"string","enum":["AVAILABLE","UNAVAILABLE"],"title":"Availability","description":"Whether a persisted Tier 1 result exists for this supported current geography."},"geography_release_id":{"type":"string","minLength":1,"title":"Geography Release Id","description":"Current governed geography release used to validate the requested FIPS."},"reason":{"anyOf":[{"type":"string","const":"NO_PUBLISHED_MODEL"},{"type":"null"}],"title":"Reason","description":"Stable reason when no persisted result is published; null when data is available."},"data":{"anyOf":[{"$ref":"#/components/schemas/Tier1CountyPriority"},{"type":"null"}],"description":"The exact persisted Tier 1 result, or null when none is published."}},"type":"object","required":["availability","geography_release_id","reason","data"],"title":"Tier1CountyPriorityAvailability","description":"Availability lookup that separates confirmed absence from request failure."},"GeographyType":{"type":"string","enum":["county","state"],"title":"GeographyType"},"ResourceEnvelope_Geography_":{"properties":{"data":{"$ref":"#/components/schemas/Geography"}},"type":"object","required":["data"],"title":"ResourceEnvelope[Geography]"},"Geography":{"properties":{"geography":{"$ref":"#/components/schemas/GeographyIdentity"},"label":{"type":"string","title":"Label"},"parent":{"anyOf":[{"$ref":"#/components/schemas/GeographyIdentity"},{"type":"null"}]}},"type":"object","required":["geography","label"],"title":"Geography","description":"County/state identity metadata; geometry is a separate display resource."},"GeographyIdentity":{"properties":{"geography_type":{"$ref":"#/components/schemas/GeographyType"},"geography_id":{"type":"string","title":"Geography Id","description":"FIPS string with leading zeros: five digits for counties, two for states."}},"type":"object","required":["geography_type","geography_id"],"title":"GeographyIdentity","description":"Stable FIPS join identity, independent of display or analysis polygons."},"CollectionEnvelope_Indicator_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Indicator"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/CollectionMeta"},"links":{"$ref":"#/components/schemas/CollectionLinks"}},"type":"object","required":["data","meta","links"],"title":"CollectionEnvelope[Indicator]"},"Indicator":{"properties":{"indicator_id":{"type":"string","title":"Indicator Id"},"label":{"type":"string","title":"Label"},"definition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Definition"},"measure_ids":{"items":{"type":"string"},"type":"array","title":"Measure Ids"},"semantic_version":{"type":"string","title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"release_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Version","description":"Governed current-release relationship version."},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations","description":"Governed interpretation limitations; preserve alongside values and versions."},"standards_mappings":{"anyOf":[{"items":{"$ref":"#/components/schemas/StandardsMapping"},"type":"array"},{"type":"null"}],"title":"Standards Mappings"}},"type":"object","required":["indicator_id","label","definition","measure_ids","semantic_version"],"title":"Indicator"},"StandardsMapping":{"properties":{"standard":{"type":"string","title":"Standard"},"version":{"type":"string","title":"Version"},"target":{"type":"string","title":"Target"},"relationship":{"type":"string","title":"Relationship"},"mapping_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mapping Reference"}},"type":"object","required":["standard","version","target","relationship"],"title":"StandardsMapping"},"CollectionMeta":{"properties":{"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","description":"Opaque query/release-bound continuation. Null means exhaustion; tokens may expire on restart."},"response_at":{"type":"string","format":"date-time","title":"Response At","description":"UTC response construction time; not source freshness or observation time."}},"type":"object","title":"CollectionMeta"},"CollectionLinks":{"properties":{"self":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Self"}},"type":"object","title":"CollectionLinks"},"ResourceEnvelope_Indicator_":{"properties":{"data":{"$ref":"#/components/schemas/Indicator"}},"type":"object","required":["data"],"title":"ResourceEnvelope[Indicator]"},"CollectionEnvelope_Measure_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Measure"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/CollectionMeta"},"links":{"$ref":"#/components/schemas/CollectionLinks"}},"type":"object","required":["data","meta","links"],"title":"CollectionEnvelope[Measure]"},"Measure":{"properties":{"measure_id":{"type":"string","title":"Measure Id"},"indicator_id":{"type":"string","title":"Indicator Id"},"label":{"type":"string","title":"Label"},"definition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Definition"},"semantic_version":{"type":"string","title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"release_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Version","description":"Governed current-release relationship version."},"measure_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measure Type"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"denominator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Denominator","description":"Governed denominator; null means it is not supplied and must not be inferred."},"geography_types":{"anyOf":[{"items":{"$ref":"#/components/schemas/GeographyType"},"type":"array"},{"type":"null"}],"title":"Geography Types"},"temporal_grains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Temporal Grains"},"geography_semantics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geography Semantics"},"temporal_semantics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temporal Semantics"},"allowed_value_states":{"anyOf":[{"items":{"$ref":"#/components/schemas/ValueState"},"type":"array"},{"type":"null"}],"title":"Allowed Value States"},"allowed_strata":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Strata"},"missingness_semantics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Missingness Semantics"},"methodology_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Methodology Id","description":"Exact governed methodology resource ID; null when not governed."},"methodology":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Methodology"},"source_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Ids"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations","description":"Governed interpretation limitations; preserve alongside values and versions."},"standards_mappings":{"anyOf":[{"items":{"$ref":"#/components/schemas/StandardsMapping"},"type":"array"},{"type":"null"}],"title":"Standards Mappings"}},"type":"object","required":["measure_id","indicator_id","label","definition","semantic_version"],"title":"Measure"},"ValueState":{"type":"string","enum":["OBSERVED","ZERO","MISSING","SUPPRESSED","UNAVAILABLE","NO_COUNTY_LINKED_RECORD","NO_RECORDS"],"title":"ValueState","description":"Public V1 states, including the governed county status added by API #54."},"ResourceEnvelope_Measure_":{"properties":{"data":{"$ref":"#/components/schemas/Measure"}},"type":"object","required":["data"],"title":"ResourceEnvelope[Measure]"},"ResourceEnvelope_Methodology_":{"properties":{"data":{"$ref":"#/components/schemas/Methodology"}},"type":"object","required":["data"],"title":"ResourceEnvelope[Methodology]"},"Methodology":{"properties":{"methodology_id":{"type":"string","title":"Methodology Id","description":"Exact governed methodology resource ID; null when not governed."},"measure_id":{"type":"string","title":"Measure Id"},"version":{"type":"string","title":"Version"},"description":{"type":"string","title":"Description"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations","description":"Governed interpretation limitations; preserve alongside values and versions."},"semantic_version":{"type":"string","title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"release_version":{"type":"string","title":"Release Version","description":"Governed current-release relationship version."}},"type":"object","required":["methodology_id","measure_id","version","description","limitations","semantic_version","release_version"],"title":"Methodology"},"CollectionEnvelope_Observation_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Observation"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/CollectionMeta"},"links":{"$ref":"#/components/schemas/CollectionLinks"}},"type":"object","required":["data","meta","links"],"title":"CollectionEnvelope[Observation]"},"Observation":{"properties":{"metadata_revision_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Revision Id","description":"Reviewed consumer-safe metadata revision; not private lineage."},"observation_id":{"type":"string","title":"Observation Id","description":"Stable observation identity and compact provenance reference."},"measure_id":{"type":"string","title":"Measure Id"},"geography":{"$ref":"#/components/schemas/GeographyIdentity"},"period_start":{"type":"string","format":"date","title":"Period Start","description":"Inclusive start of the governed observation period."},"period_end":{"type":"string","format":"date","title":"Period End","description":"Inclusive end of the governed observation period."},"temporal_grain":{"type":"string","title":"Temporal Grain"},"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value","description":"Read with value_state and unit; null never means zero."},"value_state":{"$ref":"#/components/schemas/ValueState","description":"OBSERVED is nonzero; ZERO is numeric zero; MISSING/SUPPRESSED/UNAVAILABLE require null; NO_COUNTY_LINKED_RECORD retains the literal no_county_linked_record; NO_RECORDS retains CDC's No records. Neither establishes biological absence."},"unit":{"type":"string","title":"Unit"},"denominator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Denominator","description":"Governed denominator; null means it is not supplied and must not be inferred."},"strata":{"additionalProperties":{"type":"string"},"type":"object","title":"Strata"},"source_id":{"type":"string","title":"Source Id","description":"Public source resource key; distinct from lineage_source_id and dataset_id."},"lineage_source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage Source Id"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"methodology_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Methodology Id","description":"Exact governed methodology resource ID; null when not governed."},"methodology":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Methodology"},"release_methodology_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Methodology Version"},"methodology_version":{"type":"string","title":"Methodology Version","description":"Transformation version, distinct from methodology resource version."},"semantic_version":{"type":"string","title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"release_id":{"type":"string","title":"Release Id","description":"Governed release identity for reproducibility."},"provenance_ref":{"type":"string","title":"Provenance Ref","description":"Structured observation provenance identity; not a literature citation."},"source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Label"},"source_vintage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Vintage"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"source_published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Source Published At","description":"Publisher timestamp when governed; null is not inferred freshness."},"atlas_acquired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Atlas Acquired At","description":"Atlas acquisition time when governed; distinct from source publication and processing."},"atlas_processed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Atlas Processed At","description":"Atlas processing time when governed; distinct from response time."},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations","description":"Governed interpretation limitations; preserve alongside values and versions."},"evidence":{"$ref":"#/components/schemas/EvidenceReference"},"environmental_context":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentalContext"},{"type":"null"}],"description":"Present only for reviewed environmental context. DECIMAL quantities may use exact numeric strings; native DOUBLE remains a JSON number."},"surveillance_context":{"anyOf":[{"$ref":"#/components/schemas/SurveillanceContext"},{"type":"null"}],"description":"Only supplied through an admitted Data release/bundle and supported slice. Omitted or null carries no evidence-state, comparability or lag claim. Comparison is case-definition scope only; alignment is descriptive, not causal."}},"type":"object","required":["observation_id","measure_id","geography","period_start","period_end","temporal_grain","value","value_state","unit","denominator","source_id","methodology_id","methodology_version","semantic_version","release_id","provenance_ref","limitations","evidence"],"title":"Observation"},"EvidenceReference":{"properties":{"resource_type":{"type":"string","title":"Resource Type"},"resource_id":{"type":"string","title":"Resource Id"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id","description":"Public source resource key; distinct from lineage_source_id and dataset_id."},"provenance_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provenance Ref","description":"Structured observation provenance identity; not a literature citation."},"semantic_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"methodology_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Methodology Version","description":"Transformation version, distinct from methodology resource version."},"release_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Id","description":"Governed release identity for reproducibility."},"uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uri"}},"type":"object","required":["resource_type","resource_id"],"title":"EvidenceReference"},"EnvironmentalContext":{"properties":{"coverage_status":{"type":"string","enum":["COMPLETE","PARTIAL_COVERAGE","SOURCE_MISSING","OUT_OF_SOURCE_COVERAGE"],"title":"Coverage Status"},"source_time_present":{"type":"boolean","title":"Source Time Present"},"day_convention":{"type":"string","minLength":1,"title":"Day Convention","description":"Publisher labeled 24-hour period, not a midnight calendar day."},"expected_area_m2":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Expected Area M2"},"intersected_area_m2":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Intersected Area M2"},"source_supported_area_m2":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Source Supported Area M2"},"valid_area_m2":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Valid Area M2"},"source_coverage_fraction":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Source Coverage Fraction","description":"Monthly source-supported/legal county area; separate from daily completeness."},"valid_fraction_of_supported_area":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Valid Fraction Of Supported Area","description":"Daily valid/source-supported area; completeness threshold 0.95."},"upstream_date_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upstream Date Modified","description":"Upstream modification metadata; never original publication or first availability."},"weight_version":{"type":"string","title":"Weight Version"},"geometry_version":{"type":"string","title":"Geometry Version","description":"Analysis geometry identity only; no polygons."},"metadata_revision_id":{"type":"string","title":"Metadata Revision Id"}},"type":"object","required":["coverage_status","source_time_present","day_convention","expected_area_m2","intersected_area_m2","source_supported_area_m2","valid_area_m2","source_coverage_fraction","valid_fraction_of_supported_area","upstream_date_modified","weight_version","geometry_version","metadata_revision_id"],"title":"EnvironmentalContext","description":"Coverage independent of value state; numeric strings preserve exact DECIMAL."},"SurveillanceContext":{"properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/SurveillanceEvidenceContext"},{"type":"null"}]},"methodology_comparison":{"anyOf":[{"$ref":"#/components/schemas/MethodologyComparisonContext"},{"type":"null"}]},"temporal_alignment":{"anyOf":[{"$ref":"#/components/schemas/TemporalAlignmentContext"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"SurveillanceContext"},"SurveillanceEvidenceContext":{"properties":{"contract_version":{"type":"string","const":"atlas-surveillance-evidence-v3","title":"Contract Version"},"normalized_state":{"anyOf":[{"type":"string","enum":["established","detected","unknown"]},{"type":"null"}],"title":"Normalized State","description":"Data-owned county evidence state, projected without classification. Null means the older companion did not supply normalization; unknown supports no biological absence conclusion. Original publisher value remains Observation.value."},"state":{"type":"string","enum":["established","detected_below_establishment","sampled_not_detected","no_qualifying_record","unknown"],"title":"State"},"reason_codes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Reason Codes"},"evidence_tier":{"type":"string","const":"GOVERNED_MAPPING","title":"Evidence Tier"},"observation_key":{"type":"string","title":"Observation Key"},"revision_id":{"type":"string","title":"Revision Id"},"value_state":{"type":"string","title":"Value State"},"source_rule_id":{"type":"string","title":"Source Rule Id"},"limitations":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Limitations"},"evidence_revision_id":{"type":"string","title":"Evidence Revision Id"}},"additionalProperties":false,"type":"object","required":["contract_version","state","reason_codes","evidence_tier","observation_key","revision_id","value_state","source_rule_id","limitations","evidence_revision_id"],"title":"SurveillanceEvidenceContext","description":"Data-projector evidence, never an API classification."},"MethodologyComparisonContext":{"properties":{"contract_version":{"type":"string","const":"atlas-lyme-surveillance-methodology-v1","title":"Contract Version"},"comparison_state":{"type":"string","enum":["COMPARABLE","CAUTION_REQUIRED","NOT_COMPARABLE","UNKNOWN"],"title":"Comparison State"},"reason_codes":{"items":{"type":"string"},"type":"array","title":"Reason Codes"},"methodology_era_ids":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array","title":"Methodology Era Ids"},"jurisdiction_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction Class"},"references":{"items":{"type":"string"},"type":"array","title":"References"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"left_observation_id":{"type":"string","title":"Left Observation Id","description":"Public ID of the comparison's left input."}},"additionalProperties":false,"type":"object","required":["contract_version","comparison_state","reason_codes","methodology_era_ids","jurisdiction_class","references","limitations","left_observation_id"],"title":"MethodologyComparisonContext"},"TemporalAlignmentContext":{"properties":{"contract_version":{"type":"string","const":"atlas-temporal-alignment-v1","title":"Contract Version"},"method_id":{"type":"string","title":"Method Id"},"method_version":{"type":"string","title":"Method Version"},"source_id":{"type":"string","title":"Source Id"},"measure_id":{"type":"string","title":"Measure Id"},"aggregation_rule":{"type":"string","title":"Aggregation Rule"},"coverage_denominator":{"type":"string","title":"Coverage Denominator"},"decision_cutoff":{"type":"string","format":"date-time","title":"Decision Cutoff"},"disposition":{"type":"string","enum":["ELIGIBLE","INELIGIBLE","RETROSPECTIVE_ONLY","UNKNOWN_AVAILABILITY"],"title":"Disposition"},"reason_codes":{"items":{"type":"string"},"type":"array","title":"Reason Codes"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"observation_window":{"$ref":"#/components/schemas/TemporalWindowContext"},"target_window":{"$ref":"#/components/schemas/TemporalWindowContext"},"lag":{"$ref":"#/components/schemas/TemporalLagContext"},"coverage":{"$ref":"#/components/schemas/TemporalCoverageContext"},"reference_period":{"anyOf":[{"$ref":"#/components/schemas/TemporalReferencePeriodContext"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["contract_version","method_id","method_version","source_id","measure_id","aggregation_rule","coverage_denominator","decision_cutoff","disposition","reason_codes","limitations","observation_window","target_window","lag","coverage"],"title":"TemporalAlignmentContext"},"TemporalWindowContext":{"properties":{"start":{"type":"string","format":"date","title":"Start"},"end_exclusive":{"type":"string","format":"date","title":"End Exclusive"},"calendar":{"type":"string","const":"GREGORIAN","title":"Calendar"},"timezone":{"type":"string","const":"UTC","title":"Timezone"}},"additionalProperties":false,"type":"object","required":["start","end_exclusive","calendar","timezone"],"title":"TemporalWindowContext"},"TemporalLagContext":{"properties":{"kind":{"type":"string","enum":["ZERO","FIXED","ROLLING","SEASONAL"],"title":"Kind"},"anchor":{"type":"string","enum":["START","END_EXCLUSIVE"],"title":"Anchor"},"offset_days":{"type":"integer","title":"Offset Days"},"window_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Window Days"},"season_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Season Id"}},"additionalProperties":false,"type":"object","required":["kind","anchor","offset_days"],"title":"TemporalLagContext"},"TemporalCoverageContext":{"properties":{"expected":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Expected"},"observed":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Observed"},"unit":{"type":"string","title":"Unit"},"partial_allowed":{"type":"boolean","title":"Partial Allowed"}},"additionalProperties":false,"type":"object","required":["expected","observed","unit","partial_allowed"],"title":"TemporalCoverageContext"},"TemporalReferencePeriodContext":{"properties":{"id":{"type":"string","title":"Id"},"start":{"type":"string","format":"date","title":"Start"},"end_exclusive":{"type":"string","format":"date","title":"End Exclusive"},"source_vintage":{"type":"string","title":"Source Vintage"}},"additionalProperties":false,"type":"object","required":["id","start","end_exclusive","source_vintage"],"title":"TemporalReferencePeriodContext"},"CollectionEnvelope_Source_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Source"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/CollectionMeta"},"links":{"$ref":"#/components/schemas/CollectionLinks"}},"type":"object","required":["data","meta","links"],"title":"CollectionEnvelope[Source]"},"Source":{"properties":{"source_id":{"type":"string","title":"Source Id","description":"Public source resource key; distinct from lineage_source_id and dataset_id."},"label":{"type":"string","title":"Label"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"lineage_source_id":{"type":"string","title":"Lineage Source Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"semantic_version":{"type":"string","title":"Semantic Version","description":"Governed semantic contract version, separate from HTTP V1 and application version."},"release_version":{"type":"string","title":"Release Version","description":"Governed current-release relationship version."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"source_vintage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Vintage"},"source_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Version"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At","deprecated":true},"atlas_acquired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Atlas Acquired At","description":"Atlas acquisition time when governed; distinct from source publication and processing.","deprecated":true},"upstream_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Upstream Updated At","description":"Governed publisher update time; null when unavailable."},"source_retrieved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Source Retrieved At","description":"Governed source retrieval time; null when unavailable."},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations","description":"Governed interpretation limitations; preserve alongside values and versions."}},"type":"object","required":["source_id","label","publisher","lineage_source_id","dataset_id","semantic_version","release_version"],"title":"Source"},"ResourceEnvelope_Source_":{"properties":{"data":{"$ref":"#/components/schemas/Source"}},"type":"object","required":["data"],"title":"ResourceEnvelope[Source]"},"StateReview":{"properties":{"requested_state":{"type":"string","title":"Requested State"},"methodology_id":{"type":"string","title":"Methodology Id"},"methodology_version":{"type":"string","title":"Methodology Version"},"configuration_sha256":{"type":"string","title":"Configuration Sha256"},"data_release_version":{"type":"string","title":"Data Release Version"},"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"},"requested_observation_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested Observation Context"},"effective_observation_context":{"type":"string","title":"Effective Observation Context"},"result_state":{"type":"string","enum":["candidates_found","insufficient_evidence","unsupported","none_stand_out"],"title":"Result State"},"review_candidates":{"items":{"$ref":"#/components/schemas/Candidate"},"type":"array","title":"Review Candidates"},"data_gaps":{"items":{"$ref":"#/components/schemas/DataGap"},"type":"array","title":"Data Gaps"},"coverage":{"$ref":"#/components/schemas/ReviewCoverage"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["requested_state","methodology_id","methodology_version","configuration_sha256","data_release_version","evaluated_at","requested_observation_context","effective_observation_context","result_state","review_candidates","data_gaps","coverage","limitations"],"title":"StateReview"},"Candidate":{"properties":{"county_fips":{"type":"string","title":"County Fips"},"county_name":{"type":"string","title":"County Name"},"county_url":{"type":"string","title":"County Url"},"reason_codes":{"items":{"type":"string"},"type":"array","title":"Reason Codes"},"reason_text":{"type":"string","title":"Reason Text"},"evidence_families":{"items":{"type":"string"},"type":"array","title":"Evidence Families"},"evidence_references":{"items":{"$ref":"#/components/schemas/PublicReviewEvidenceReference"},"type":"array","title":"Evidence References"},"completeness":{"type":"string","const":"limited","title":"Completeness","default":"limited"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"freshness_comparability":{"type":"string","title":"Freshness Comparability"},"suggested_next_check":{"type":"string","title":"Suggested Next Check"}},"type":"object","required":["county_fips","county_name","county_url","reason_codes","reason_text","evidence_families","evidence_references","limitations","freshness_comparability","suggested_next_check"],"title":"Candidate"},"PublicReviewEvidenceReference":{"properties":{"family":{"type":"string","title":"Family"},"source_product":{"type":"string","title":"Source Product"},"source_version":{"type":"string","title":"Source Version"},"public_record_ref":{"type":"string","title":"Public Record Ref"},"county_fips":{"type":"string","title":"County Fips"},"release_id":{"type":"string","title":"Release Id"},"source_as_of":{"type":"string","title":"Source As Of"},"retrieved_at":{"type":"string","format":"date-time","title":"Retrieved At"},"target":{"type":"string","title":"Target"},"status":{"type":"string","title":"Status"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["family","source_product","source_version","public_record_ref","county_fips","release_id","source_as_of","retrieved_at","target","status","limitations"],"title":"PublicReviewEvidenceReference"},"DataGap":{"properties":{"county_fips":{"type":"string","title":"County Fips"},"code":{"type":"string","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["county_fips","code","detail"],"title":"DataGap"},"ReviewCoverage":{"properties":{"assessed_counties":{"type":"integer","title":"Assessed Counties"},"eligible_counties":{"type":"integer","title":"Eligible Counties"},"abstained_counties":{"type":"integer","title":"Abstained Counties"},"evaluated_counties":{"type":"integer","title":"Evaluated Counties"},"rule_coverage":{"additionalProperties":{"type":"string"},"type":"object","title":"Rule Coverage"}},"type":"object","required":["assessed_counties","eligible_counties","abstained_counties","evaluated_counties","rule_coverage"],"title":"ReviewCoverage"}}}}