healthcare.dev docs
API referenceDatasets

Dataset catalog

GET /v1/datasets

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

Every published dataset with its current version, publish time, expected cadence and freshness.

Requires an API key: Authorization: Bearer hdev_live_.... See Authentication.

Examples

curl

curl "https://api.healthcare.dev/v1/datasets" \
  -H "Authorization: Bearer $HDEV_API_KEY"

TypeScript

const res = await fetch("https://api.healthcare.dev/v1/datasets", {
  headers: { Authorization: `Bearer ${process.env.HDEV_API_KEY}` },
});
const { data, meta } = await res.json();

Python

import os
import requests

res = requests.get("https://api.healthcare.dev/v1/datasets", headers={"Authorization": f"Bearer {os.environ['HDEV_API_KEY']}"})
body = res.json()

Try it

GEThttps://api.healthcare.dev/v1/datasets
Get a free key
Copy as curl
curl "https://api.healthcare.dev/v1/datasets" \
  -H "Authorization: Bearer $HDEV_API_KEY"

Response

Datasets

{
  "data": [
    {
      "id": "icd10cm",
      "name": "ICD-10-CM",
      "source": "cms-icd10",
      "license": "Public domain (CMS)",
      "current_version": "2026.1",
      "published_at": "2026-10-01T06:00:00Z",
      "expected_cadence_days": 365,
      "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/datasets",
    "next": "/v1/datasets?cursor=eyJrIjoiRTExLjkifQ"
  }
}

Fields

FieldTypeAlways presentDescription
idstringyesDataset id, e.g. nppes, icd10cm
namestringyes
sourcestringyes
licensestringyes
source_urlstring | null (uri)yesUpstream page the data is published on
current_versionstring | nullyes
published_atstring | null (date-time)yes
expected_cadence_daysintegeryes
freshbooleanyesFalse when older than 1.5x the expected cadence

Errors

Errors are application/problem+json (RFC 9457). Branch on type, not on title. See Errors.

StatustypeWhen
401unauthorizedMissing, malformed or revoked API key.
429rate-limited / quota-exceededToo many requests per second (retry after Retry-After), or the monthly quota is used up.

On this page