API Documentation
← API overview

Drug Pricing

2 endpoints · every section below is generated from the API catalog

GET/api/v1/drug-pricing

Search

Available on FreeFull reference →

Returns paginated Medicare drug pricing records with a data array and meta (page, limit, totalItems, totalPages). Call it to look up drug prices by name, NDC, application number, classification, generic status, price range, or date range; a non-empty search switches to relevance-style matching. Returns 400 for invalid query parameters, 503 when the index is unavailable on this deployment, and 500 on other failures.

Rate limit: medicareApiCallsPerDay · Free plan: 10/day

Parameters

ParameterTypeRequiredDescription
searchstringNomaximum length 500
ndcstringNomaximum length 100
application_numberstringNomaximum length 50
classificationstringNomaximum length 50
is_genericbooleanNobooleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
min_pricenumberNoLower bound on price.
max_pricenumberNoUpper bound on price.
min_datestringNomaximum length 20
max_datestringNomaximum length 20
pagenumberNoMin 1; default 1 (min 1; default 1)
Range: 1 to ∞
limitnumberNoRange 1-100; default 20 (range 1-100; default 20)
Range: 1 to 100
sortstringNoDefault date (default date)
Allowed values: date, price, key
orderstringNoDefault desc (default desc)
Allowed values: asc, desc

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/drug-pricing"
GET/api/v1/drug-pricing/:key

Details

Available on FreeFull reference →

Returns the pricing record for a single drug product identified by its key. Call it when you already have a product key and need that product's pricing details. Returns 404 if no product matches the key, and 500 on an internal failure.

Rate limit: medicareApiCallsPerDay · Free plan: 10/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/drug-pricing/{key}"