# Overview

URL: https://docs.healthcare.dev/reference

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`](https://api.healthcare.dev/openapi.json) and [`/openapi.json`](/openapi.json) on this site.

## Codes

| Endpoint | What it does |
| --- | --- |
| [`GET /v1/codes/{system}/{code}`](/reference/codes/look-up-a-code) | Look up a code |
| [`GET /v1/codes/{system}`](/reference/codes/search-codes) | Search codes |
| [`GET /v1/codes/{system}/{code}/children`](/reference/codes/child-codes) | Child codes |
| [`GET /v1/codes/{system}/{code}/parents`](/reference/codes/ancestor-codes) | Ancestor codes |
| [`GET /v1/codes/{system}/{code}/hierarchy`](/reference/codes/code-with-ancestors-and-children) | Code with ancestors and children |
| [`POST /v1/codes/{system}/batch`](/reference/codes/look-up-up-to-100-codes) | Look up up to 100 codes |

## Drugs

| Endpoint | What it does |
| --- | --- |
| [`GET /v1/drugs/ndc/{ndc}`](/reference/drugs/look-up-an-ndc) | Look up an NDC |
| [`GET /v1/drugs/rxnorm/{rxcui}`](/reference/drugs/look-up-an-rxnorm-concept) | Look up an RxNorm concept |
| [`GET /v1/drugs/rxnorm`](/reference/drugs/search-rxnorm) | Search RxNorm |
| [`GET /v1/drugs/search`](/reference/drugs/search-drugs-across-rxnorm-and-ndc) | Search drugs across RxNorm and NDC |

## Datasets

| Endpoint | What it does |
| --- | --- |
| [`GET /v1/datasets`](/reference/datasets/dataset-catalog) | Dataset catalog |
| [`GET /v1/changes`](/reference/datasets/change-feed) | Change feed |

## Taxonomies

| Endpoint | What it does |
| --- | --- |
| [`GET /v1/taxonomies/{code}`](/reference/taxonomies/look-up-a-provider-taxonomy-code) | Look up a provider taxonomy code |
| [`GET /v1/taxonomies`](/reference/taxonomies/search-provider-taxonomies) | Search provider taxonomies |

## Service

| Endpoint | What it does |
| --- | --- |
| [`GET /healthz`](/reference/service/process-liveness) | Process liveness |
| [`GET /readyz`](/reference/service/dependency-readiness) | Dependency readiness |
| [`GET /v1/status`](/reference/service/service-and-data-freshness-status) | Service and data freshness status |