Specialties

List all available specialties

get/api/v1/specialties

Request

Base URL: https://fonteum.com
URL: https://fonteum.com/api/v1/specialties
Auth: HTTP bearer

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

Specialty list.

Example response

{
  "data": [
    {
      "slug": "dermatology",
      "display_name": "Dermatology",
      "taxonomy_codes": [
        "207N00000X"
      ],
      "study_url": "https://fonteum.com/research"
    }
  ],
  "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.