API referenceEval packs
List eval packs
GET /v1/eval-packs
GET https://api.healthcare.dev/v1/eval-packsEval packs: versioned question sets with verified answers and citations for testing your agent, in coding, drugs and providers. Every pack with every version (newest first), its question count and the dataset versions its answers were verified against. Team plan (403 plan-upgrade-required on other plans). Not metered.
Requires an API key: Authorization: Bearer hdev_live_.... See Authentication.
Examples
curl
curl "https://api.healthcare.dev/v1/eval-packs" \
-H "Authorization: Bearer $HDEV_API_KEY"TypeScript
const res = await fetch("https://api.healthcare.dev/v1/eval-packs", {
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/eval-packs", headers={"Authorization": f"Bearer {os.environ['HDEV_API_KEY']}"})
body = res.json()Try it
Response
Packs
{
"data": [
{
"pack": "coding",
"title": "string",
"description": "string",
"latest": "2026.10.1",
"versions": [
{
"version": null,
"built_at": null,
"as_of": null,
"question_count": null,
"datasets": null
}
]
}
],
"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/eval-packs",
"next": "/v1/eval-packs?cursor=eyJrIjoiRTExLjkifQ"
}
}Fields
| Field | Type | Always present | Description |
|---|---|---|---|
pack | EvalPackId | yes | coding (ICD-10-CM and HCPCS Level II), drugs (NDC Directory, RxNorm, FDA shortages) or providers (Medicare enrollment, opt-out and OIG exclusions by NPI) |
title | string | yes | |
description | string | yes | |
latest | string | null | yes | The newest version, or null before the first |
versions | EvalPackVersionSummary[] | yes | Every version, newest first |
Errors
Errors are application/problem+json (RFC 9457). Branch on type, not on title. See Errors.
| Status | type | When |
|---|---|---|
| 401 | unauthorized | Missing, malformed or revoked API key. |
| 403 | plan-upgrade-required | The plan doesn't include this feature; required_plan names the plan that does. |
| 429 | rate-limited / quota-exceeded | Too many requests per second (retry after Retry-After), or the monthly quota is used up. |