Skip to main content
POST
Returns Medicare Part D programme spending before rebates, by calendar year, from the US Centers for Medicare & Medicaid Services. Overall is the total across manufacturers; manufacturers can be included separately. Figures include spending, dosage units, claims, beneficiaries and average spending. The series updates annually and supplies the latest five calendar years.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
Exact brand name, for example Eliquis. 2 to 100 characters.
string
Exact generic name, for example Apixaban. 2 to 100 characters.
boolean
Include per-manufacturer rows in addition to Overall totals. Defaults to false.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always market_medicare_drug_spending
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US Centers for Medicare & Medicaid Services.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
The figures are for the calendar years listed. The source rows carry no date, so as_of is null.

Result

Nested under data.result.
object[]
Drugs.
string
Brand name.
string
Generic name.
string
Overall is the total across manufacturers.
number | null
Manufacturer count. null when the source gives no value.
object[]
Years.
integer
Year.
number | null
Total spending usd. null when the source gives no value.
number | null
Dosage units. null when the source gives no value.
number | null
Claims. null when the source gives no value.
number | null
Beneficiaries. null when the source gives no value.
number | null
Avg spend per dosage unit usd. null when the source gives no value.
number | null
Avg spend per claim usd. null when the source gives no value.
number | null
Avg spend per beneficiary usd. null when the source gives no value.
boolean | null
Source outlier flag; null when blank or absent.
number | null
Source fractional change in the last calendar year. null when the source gives no value.
number | null
Source compound annual growth rate across the listed years. null when the source gives no value.
integer
Latest year.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • Provide brand_name, generic_name, or both. Both exact-match filters apply when both are supplied.
  • Reads one source page of up to 50 rows, including manufacturer rows before filtering; broad matches may be incomplete.
  • Empty source values become null. No match completes with drugs: [].
  • Results return inline. The finished job stays available at /v1/requests/{request_id}