States

Combined per-specialty coverage for one state

get/api/v1/states/{state}/coverage

Request

Base URL: https://fonteum.com
URL: https://fonteum.com/api/v1/states/{state}/coverage
Auth: HTTP bearer

Path parameters

statestring required

Example:CA

Query parameters

max_stalenessstring

Example:48h

Caller stored-snapshot age bar (moat-defense #125). A positive duration — 48h, 7d, 90m, or a bare number of hours. The maximum age any consulted stored source snapshot may have for this request; it is not an upstream-release freshness guarantee. Response carries meta.freshness_policy; absence of the parameter leaves default behaviour unchanged.

max_staleness_mode'flag' | 'reject'

What to do when a source is behind the max_staleness bar: flag (default) returns 200 with a stale flag; reject returns 409. on_stale=reject|409 is accepted as an alias.

Response

Per-specialty rollup.

dataobject

Example response

{
  "meta": {
    "request_id": "req_abc123def456",
    "freshness": [
      {
        "source_id": "oig-leie"
      }
    ],
    "freshness_policy": {
      "max_staleness": "48h",
      "max_staleness_hours": 48
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.