API reference
Overview
Every endpoint of the healthcare.dev API, generated from the OpenAPI 3.1 spec.
US healthcare reference data. Reference data only, not clinical advice. Never send PHI.
Base URL: https://api.healthcare.dev. The machine-readable spec is at https://api.healthcare.dev/openapi.json and /openapi.json on this site.
Codes
| Endpoint | What it does |
|---|---|
GET /v1/codes/{system}/{code} | Look up a code |
GET /v1/codes/{system} | Search codes |
GET /v1/codes/{system}/{code}/children | Child codes |
GET /v1/codes/{system}/{code}/parents | Ancestor codes |
GET /v1/codes/{system}/{code}/hierarchy | Code with ancestors and children |
POST /v1/codes/{system}/batch | Look up up to 100 codes |
Drugs
| Endpoint | What it does |
|---|---|
GET /v1/drugs/ndc/{ndc} | Look up an NDC |
GET /v1/drugs/rxnorm/{rxcui} | Look up an RxNorm concept |
GET /v1/drugs/rxnorm | Search RxNorm |
GET /v1/drugs/search | Search drugs across RxNorm and NDC |
Datasets
| Endpoint | What it does |
|---|---|
GET /v1/datasets | Dataset catalog |
GET /v1/changes | Change feed |
Taxonomies
| Endpoint | What it does |
|---|---|
GET /v1/taxonomies/{code} | Look up a provider taxonomy code |
GET /v1/taxonomies | Search provider taxonomies |
Service
| Endpoint | What it does |
|---|---|
GET /healthz | Process liveness |
GET /readyz | Dependency readiness |
GET /v1/status | Service and data freshness status |