OpenAPI, GitHub, and support

These guides explain how to call the public API. The contract itself stays in the owning service.

OpenAPI

Surface	Status	URL
Production API	Available	https://api.onehealthatlas.org
OpenAPI schema	Available	openapi.json
Swagger reference	Available	Swagger reference
ReDoc reference	Available	ReDoc reference
Generated reference in this site	Rendered from the pinned public spec	API reference

The generated section uses these paths:

Path	Contents
API reference	Document version, source commit, and the operation index
Discovery	Indicators and measures
Observations	Observation query
Provenance	Sources and methodologies
Geographies	Geography identity
Atlas	Legacy metadata, scores, geometry, and ranking export
Counties	Legacy county analytics and reports
States	Legacy state review and reports
Schemas	Component schemas, including ProblemDetails

Use those pages for parameters, schemas, and the contract's own examples. Use the developer overview when you need the task and the meaning of a field.

/v1 is the HTTP contract. OpenAPI info.version is the application version. They are different identifiers.

GitHub

Repository	What it owns
one-health-lyme-gap-atlas-api	The public HTTP contract and openapi.json
one-health-lyme-gap-atlas-web	This documentation site and the Atlas web application
one-health-lyme-gap-atlas-mcp	The MCP server. It is not required for public REST reads

Contract questions belong with the API repository. Guide wording belongs with the web repository. API, MCP, and access records the current MCP boundary: bounded anonymous read-only evidence tools, with county identity kept separate from evidence. The September 2026 smoke-only receipt is historical.

Support

Include these items when you report a failed or surprising read:

• The full request URL, without an Authorization header. Public reads do not use one.
• The HTTP status and content-type.
• request_id from the problem body.
• Retry-After when the status is 429 or 503.
• For a successful observation, measure_id, geography_id, period, value_state, release_id, and semantic_version.

There is no API key to rotate and no SDK version to report.

Unavailable in this contract

Item	Status
Numeric rate-limit quota and concurrency cap	Not published in the public OpenAPI document. Honor Retry-After
Geography identity payload	Declared route currently returns 503 CANONICAL_DATA_UNAVAILABLE and no geometry
Daily environmental measure id	Described on the observations operation. Not present in the current measures catalog. Read environmental_context only when an observation includes it
API keys, required SDKs, and required MCP tools	Not part of anonymous public reads
Account, feedback, conversational AI, and literature retrieval	Excluded from the public OpenAPI document