/api/v1/drug-pricingSearch
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.
When to use it
- Look up Medicare drug prices by drug name
- Filter drug pricing records by NDC or application number
- Find generic or brand drugs within a price or date range
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for medicareApiCallsPerDay. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 10 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | No | maximum length 500 |
| ndc | string | No | maximum length 100 |
| application_number | string | No | maximum length 50 |
| classification | string | No | maximum length 50 |
| is_generic | boolean | No | booleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side |
| min_price | number | No | Lower bound on price. |
| max_price | number | No | Upper bound on price. |
| min_date | string | No | maximum length 20 |
| max_date | string | No | maximum length 20 |
| page | number | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100 |
| sort | string | No | Default date (default date) Allowed values: date, price, key |
| order | string | No | Default 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"
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.Catalog version mcp-2026-10-28 · generated from the live MCP catalog