healthcare.dev docs

healthcare.dev

One API for current, versioned US healthcare reference data. REST, MCP, TypeScript SDK and CLI.

healthcare.dev serves US healthcare reference data (diagnosis and procedure codes, HCPCS, drugs, and soon providers) through one consistent API. Every response says where the data came from and which release it is, so you and your agents can cite it.

curl https://api.healthcare.dev/v1/codes/icd10cm/E11.9 \
  -H "Authorization: Bearer $HDEV_API_KEY"

Start here

  • Quickstart: your first call in under two minutes.
  • MCP server: give Claude, Cursor, Codex or VS Code direct access to the data.
  • API reference: every endpoint, generated from the OpenAPI spec.

What you get

DatasetSourceUpdatedEndpoint
ICD-10-CMCMS, CDC NCHSYearly/v1/codes/icd10cm
ICD-10-PCSCMSYearly/v1/codes/icd10pcs
HCPCS Level IICMSQuarterly/v1/codes/hcpcs
NDC DirectoryFDADaily/v1/drugs/ndc
RxNormNLMMonthly/v1/drugs/rxnorm
NPI registry (soon)CMS NPPESWeekly/v1/providers

Ground rules

  • Reference data, not medical advice. Nothing here is clinical, coding or billing advice.
  • No PHI, ever. Send only identifiers of public things (codes, NDCs, NPIs, names of drugs). Never send patient names, dates of birth, member IDs or anything else about a person.
  • Always cite. Each response carries meta.source, meta.data_version and meta.license.

For agents

Machine-readable entry points: /llms.txt, /llms-full.txt, /openapi.json, and a Markdown copy of every page (add .md to the URL, for example /quickstart.md). See Agent skill.

On this page