healthcare.dev docs
API referenceService

Service and data freshness status

GET /v1/status

GET https://api.healthcare.dev/v1/status

Public, no authentication. degraded when any dataset is older than 1.5x its expected cadence.

Public: no API key needed.

Examples

curl

curl "https://api.healthcare.dev/v1/status"

TypeScript

const res = await fetch("https://api.healthcare.dev/v1/status");
const { data, meta } = await res.json();

Python

import requests

res = requests.get("https://api.healthcare.dev/v1/status")
body = res.json()

Try it

GEThttps://api.healthcare.dev/v1/status
Copy as curl
curl "https://api.healthcare.dev/v1/status"

Response

Status

{
  "data": {
    "status": "ok",
    "datasets": [
      {
        "id": "string",
        "version": "string",
        "published_at": "string",
        "fresh": true
      }
    ]
  },
  "meta": {
    "source": "cms-icd10",
    "data_version": "2026.1",
    "retrieved_at": "2026-10-24T12:00:00Z",
    "license": "Public domain (CMS). Reference data, not medical advice."
  },
  "links": {
    "self": "/v1/status",
    "next": null
  }
}

Fields

FieldTypeAlways presentDescription
status"ok" | "degraded"yes
datasetsobject[]yes

On this page