/api/v1/medicare-drugs/:keyMedicare Drug Record
Retrieve ONE Medicare Part D drug's full 2025 spending record by its unique _key (derived from the generic name, e.g. 'aripiprazole'). Returns the full document including brand names, spending/claims/beneficiary metrics, the linked ChEMBL molecule and approved indications (already deduplicated by efo_id server-side). Use after a Medicare Drug Spending Search; copy the exact _key string from a result - never construct or guess it.
When to use it
- full spending detail for one Medicare drug
- approved indications (efo_id + disease_name) for a drug
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key(path) | string | Yes | Unique drug _key derived from the generic name (e.g. 'aripiprazole'). Copy it exactly from the '_key' field of a Medicare Drug Spending Search record; do not construct it from the drug name. |
Query parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/medicare-drugs/{key}"Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Response shape
Payload: data.approved_indications — Approved Indications (secondary list)
Common row fields
| Field | Description |
|---|---|
| efo_id | Record identifier |
| disease_name | Main display field |
Empty results: No record found (HTTP 404)
approved_indications is deduplicated by efo_id server-side (this record and the search rows share the same transform) - count entries as-is. avg_spending_per_claim / avg_spending_per_beneficiary are server-computed and null when the denominator is 0.
Catalog version 0.0.0-generated · generated from the API source