--- type: "firecrawl-provider" description: "CMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line." use_when: "CMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line.\n\nCMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line." categories: "Life sciences" capabilities: 15 credits_per_call: 5 --- # CMS data.cms.gov on Firecrawl Alexandria CMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line. - Categories: Life sciences - Category index: [Life sciences category](https://alexandria.firecrawl.dev/agents/categories/life-sciences) - Provider key: `data-cms-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/data-cms-gov) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/openapi.json) ## Capabilities - [Dialysis facilities](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/dialysis_facilities): Search CMS Dialysis Facility Care Compare by state, city, ZIP, name or five-star rating. Each result carries the CCN, address, ESRD network, ownership, chain, star rating, station count, late shift and the dialysis modalities offered. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - [Dialysis facility](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/dialysis_facility): Return one CMS Dialysis Facility Care Compare facility by CCN: identity, chain and ownership, modalities, star rating with its period, and eleven standardized outcomes (survival, hospitalization, readmission, transfusion, transplant waitlisting, ED visits, modality switch, bloodstream infection, fistula) with categories, confidence limits and periods. - [Home health agencies](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/home_health_agencies): Search CMS Home Health Care Compare agencies by state, city, ZIP, name or quality of patient care star rating. Each result carries the CCN, address, ownership, certification date and the half-star quality of patient care rating with CMS's footnote when unrated. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - [Home health agency](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/home_health_agency): Return one CMS Home Health Care Compare agency by CCN: identity, ownership, services offered, quality of patient care star rating, twelve OASIS patient-care measures with numerators and denominators, three claims-based risk-standardized outcomes and Medicare spending per episode. - [Hospital](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/hospital): Return one CMS Care Compare hospital by CCN: identity, type, ownership, emergency services, Birthing-Friendly designation, Overall Hospital Quality Star Rating with footnote, and the mortality, safety, readmission, patient experience and timely-and-effective-care measure-group counts behind it. - [Hospitals](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/hospitals): Search CMS Care Compare hospitals (Hospital General Information) by state, city, ZIP, name or overall star rating. Each result carries the CCN, address, hospital type, ownership, emergency services and the Overall Hospital Quality Star Rating. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - [Nursing home](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/nursing_home): Return one CMS Nursing Home Care Compare provider by CCN: identity, ownership and chain, all six star ratings with footnotes, payroll-based staffing hours and turnover, latest inspection results, fines and payment denials, coordinates and the CMS processing date. - [Nursing homes](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/nursing_homes): Search CMS Nursing Home Care Compare (Provider Information) by state, city, ZIP, name or overall star rating. Each result carries the CCN, address, ownership, certified beds, the overall, health inspection, quality measure and staffing star ratings, Special Focus Facility status and the abuse icon. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - [Utilization](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/utilization): Return public CMS procedure-volume rows by clinician NPI, including suppressed 1-10 counts as inclusive bounds, volume percentile where reported, and profile display indicator. Some public rows are marked N by CMS and should not appear on clinician profiles; filter displayed_on_profile for profile-facing use. The recent 12-month Medicare observation window has a three-month claims-processing lag; exact measurement dates are not supplied by this API. - [Drug spending datasets](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/drug_spending_datasets): Catalogue of the six Medicare and Medicaid Spending by Drug datasets on data.cms.gov (Part D, Part B and Medicaid annual spending by drug; quarterly Part D and Part B; Part D Prescribers by Geography and Drug): stable dataset uuid, current version uuid and label, catalogue `modified` date, reporting periods, row and column counts, CSV URL, size and publisher SHA-1, attachments, and every published version with its row count. Read from the slug resolver, dataset-resources, data-viewer metadata and the Drupal JSON:API version list; four to five requests per dataset. - [Records get](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/records_get): One drug spending record by its source_record_id (dataset key plus key columns, plus the period for annual and quarterly datasets), read with an exact `filter[Col]=` query against the current release. Same record shape as records_list. - [Records list](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/records_list): Full current contents of one drug spending dataset, in pages of up to 5000 source rows read from the data API (`/dataset/{version}/data?size=&offset=`), addressed by the pinned version uuid. Annual rows are unpivoted to one record per restated year (five records per source row); quarterly and geography rows map one to one. The cursor pins the version uuid and the publisher's CSV SHA-1; every page re-reads both and fails with invalid_input at /continuation (issue code `publication_changed`) when the release moved, instead of mixing releases. Each record carries source_record_id, source_url, publication_id and retrieved_at. Spending is gross of rebates. - [Search](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/search): Look up what Medicare and Medicaid spend on a drug, from CMS's annual Spending by Drug datasets for Medicare Part D (prescriptions patients fill), Medicare Part B (drugs given in clinics and hospital outpatient departments, by HCPCS code) and Medicaid. Matches a brand or generic name, or part of one, case-insensitively (and a HCPCS code for Part B), and returns every matching drug per program with up to five years of total spending, dosage units, claims, beneficiaries (Medicare only), average spending per dosage unit, claim and beneficiary, CMS's outlier flag, the latest-year change and compound annual growth of unit cost, the manufacturers (Part D, Medicaid) and the Part B average sales price. Drugs come largest latest-year spending first; `datasets` gives each program's years, release date and match count. Spending is gross of manufacturer rebates. No match is an empty result. - [Source status](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/source_status): Cheap version check for one drug spending dataset: current version uuid (publication id), version label, published date, primary CSV URL and size, the publisher's CSV SHA-1 as content hash, file modification time, row and column counts and import status. Three small requests (slug resolver, dataset-resources, data-viewer metadata); no rows are read. - [Top](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/top): Rank the drugs in one CMS Spending by Drug dataset (Medicare Part D, Medicare Part B or Medicaid) for one year by total spending, claims, beneficiaries, average spending per beneficiary, or the latest-year change in average spending per dosage unit, highest or lowest first, optionally only drugs above a spending floor. Each result is the drug's full record, as in `search`, with its manufacturers. Part D and Medicaid are ranked on their drug-level rows, so a drug counts once however many manufacturers make it. Spending is gross of manufacturer rebates. ## 1. Choose this provider when CMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line. CMS data.cms.gov: Provider Data Catalog datasets (NPI-keyed clinician procedure volume; Care Compare search and detail for hospitals, nursing homes, home health agencies and dialysis facilities); what Medicare Part D, Medicare Part B and Medicaid spend on each drug, searched by brand or generic name or ranked by spending, claims, patients or unit-cost growth; and the Medicare and Medicaid Spending by Drug collectors (Part D, Part B and Medicaid annual and quarterly spending by drug and manufacturer, Part D prescribing by geography and drug): dataset catalogue, version status, full paged listing pinned to one release, and single-record lookup. CMS data is a U.S. Government work; spending answers carry CMS's attribution line. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "data-cms-gov", "capability": "clinician-procedure-volume/dialysis_facilities", "options": { "city": "Rochester", "state": "MN" } } ``` ## 3. Add provider options Use only the options needed for the task: - `city` (string): City name, exact match, case-insensitive. Example: `` - `limit` (number): Results per page. Example: `25` - `name` (string): Case-insensitive substring of the dialysis facility name. Example: `` - `offset` (number): Results to skip; pass next_offset from the previous page. Example: `0` - `star_rating` (number): Only facilities with exactly this star rating. Example: `1` - `state` (string): Two-letter USPS state or territory code. Pattern: ^[A-Za-z]{2}$. Example: `` - `zip_code` (string): Five-digit ZIP code, exact match. Pattern: ^[0-9]{5}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-cms-gov", capability: "clinician-procedure-volume/dialysis_facilities", options: { city: "Rochester", state: "MN", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-cms-gov", "capability": "clinician-procedure-volume/dialysis_facilities", "options": { "city": "Rochester", "state": "MN" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-cms-gov", "capability": "clinician-procedure-volume/dialysis_facilities", "options": { "city": "Rochester", "state": "MN" } } }' ``` ### CLI ```sh firecrawl scrape 'data-cms-gov/clinician-procedure-volume/dialysis_facilities' \ --options '{"city":"Rochester","state":"MN"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-cms-gov", "capability": "clinician-procedure-volume/dialysis_facilities", "options": { "city": "Rochester", "state": "MN" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-cms-gov", "capability": "clinician-procedure-volume/dialysis_facilities", "options": { "city": "Rochester", "state": "MN" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "limit": 25, "next_offset": null, "offset": 0, "results": [ { "address": "201 W CENTER ST, EI-1G", "address_line_2": null, "ccn": "242309", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO DIALYSIS ROCHESTER METHODIST HOSP", "network": 11, "offers_home_hemodialysis_training": true, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": true, "ownership": "Non-profit", "phone": "(507) 266-8733", "star_rating": 2, "state": "MN", "stations": 39, "zip_code": "55905" }, { "address": "1216 2ND ST SW", "address_line_2": "Joseph Building 2B Dialysis", "ccn": "242324", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO CLINIC DIALYSIS ST MARYS", "network": 11, "offers_home_hemodialysis_training": false, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": false, "ownership": "Non-profit", "phone": "(507) 255-4095", "star_rating": null, "state": "MN", "stations": 3, "zip_code": "55902" }, { "address": "2660 S BROADWAY STE A", "address_line_2": null, "ccn": "242600", "chain_organization": "DaVita", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "DaVita Rochester Dialysis", "network": 11, "offers_home_hemodialysis_training": true, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": true, "ownership": "Profit", "phone": "(507) 288-1617", "star_rating": 2, "state": "MN", "stations": 12, "zip_code": "55904" }, { "address": "3041 STONEHEDGE DRIVE NE", "address_line_2": null, "ccn": "243532", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO DIALYSIS ROCHESTER - NORTHEAST", "network": 11, "offers_home_hemodialysis_training": false, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": false, "ownership": "Non-profit", "phone": "(507) 538-8580", "star_rating": 2, "state": "MN", "stations": 24, "zip_code": "55906" } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/23ew-n7w9/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=MN&conditions%5B1%5D%5Bproperty%5D=citytown&conditions%5B1%5D%5Bvalue%5D=Rochester&sorts%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&sorts%5B0%5D%5Border%5D=asc&limit=25&offset=0", "total": 4 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Dialysis facilities - Capability: `clinician-procedure-volume/dialysis_facilities` - Description: Search CMS Dialysis Facility Care Compare by state, city, ZIP, name or five-star rating. Each result carries the CCN, address, ESRD network, ownership, chain, star rating, station count, late shift and the dialysis modalities offered. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - Instructions: Find Medicare-certified dialysis facilities and their CMS star ratings and modalities. Use dialysis_facility with a CCN for standardized outcomes. - Cost: 5 credits per call - Capability file: [Dialysis facilities](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/dialysis_facilities) Accepted options: - `city` (string): City name, exact match, case-insensitive. Example: `` - `limit` (number): Results per page. Example: `25` - `name` (string): Case-insensitive substring of the dialysis facility name. Example: `` - `offset` (number): Results to skip; pass next_offset from the previous page. Example: `0` - `star_rating` (number): Only facilities with exactly this star rating. Example: `1` - `state` (string): Two-letter USPS state or territory code. Pattern: ^[A-Za-z]{2}$. Example: `` - `zip_code` (string): Five-digit ZIP code, exact match. Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "limit": 25, "next_offset": null, "offset": 0, "results": [ { "address": "201 W CENTER ST, EI-1G", "address_line_2": null, "ccn": "242309", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO DIALYSIS ROCHESTER METHODIST HOSP", "network": 11, "offers_home_hemodialysis_training": true, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": true, "ownership": "Non-profit", "phone": "(507) 266-8733", "star_rating": 2, "state": "MN", "stations": 39, "zip_code": "55905" }, { "address": "1216 2ND ST SW", "address_line_2": "Joseph Building 2B Dialysis", "ccn": "242324", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO CLINIC DIALYSIS ST MARYS", "network": 11, "offers_home_hemodialysis_training": false, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": false, "ownership": "Non-profit", "phone": "(507) 255-4095", "star_rating": null, "state": "MN", "stations": 3, "zip_code": "55902" }, { "address": "2660 S BROADWAY STE A", "address_line_2": null, "ccn": "242600", "chain_organization": "DaVita", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "DaVita Rochester Dialysis", "network": 11, "offers_home_hemodialysis_training": true, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": true, "ownership": "Profit", "phone": "(507) 288-1617", "star_rating": 2, "state": "MN", "stations": 12, "zip_code": "55904" }, { "address": "3041 STONEHEDGE DRIVE NE", "address_line_2": null, "ccn": "243532", "chain_organization": "Mayo Clinic Dialysis", "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO DIALYSIS ROCHESTER - NORTHEAST", "network": 11, "offers_home_hemodialysis_training": false, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": false, "ownership": "Non-profit", "phone": "(507) 538-8580", "star_rating": 2, "state": "MN", "stations": 24, "zip_code": "55906" } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/23ew-n7w9/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=MN&conditions%5B1%5D%5Bproperty%5D=citytown&conditions%5B1%5D%5Bvalue%5D=Rochester&sorts%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&sorts%5B0%5D%5Border%5D=asc&limit=25&offset=0", "total": 4 } ``` ### Dialysis facility - Capability: `clinician-procedure-volume/dialysis_facility` - Description: Return one CMS Dialysis Facility Care Compare facility by CCN: identity, chain and ownership, modalities, star rating with its period, and eleven standardized outcomes (survival, hospitalization, readmission, transfusion, transplant waitlisting, ED visits, modality switch, bloodstream infection, fistula) with categories, confidence limits and periods. - Instructions: Look up a dialysis facility's CMS star rating and patient outcomes versus expected. Get the CCN from dialysis_facilities. - Cost: 5 credits per call - Capability file: [Dialysis facility](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/dialysis_facility) Accepted options: - `ccn` (string, required): Six-character CMS Certification Number (CCN), as returned by the matching search function. Pattern: ^[0-9A-Za-z]{6}$. Example: `` Response schema example: ```json { "address": "201 W CENTER ST, EI-1G", "address_line_2": null, "ccn": "242309", "certification_date": "1977-09-01", "chain_organization": "Mayo Clinic Dialysis", "chain_owned": true, "city": "ROCHESTER", "county": "Olmsted", "late_shift": false, "name": "MAYO DIALYSIS ROCHESTER METHODIST HOSP", "network": 11, "offers_home_hemodialysis_training": true, "offers_in_center_hemodialysis": true, "offers_peritoneal_dialysis": true, "outcomes": { "bloodstream_infection": { "availability_code": "001", "category": "Better than Expected", "lower_limit": 0.12, "patients": null, "period": { "end": "2024-12-31", "start": "2024-01-01" }, "upper_limit": 0.91, "value": 0.38 }, "emergency_visits": { "availability_code": "001", "category": "As Expected", "lower_limit": 0.79, "patients": 79, "period": { "end": "2024-12-31", "start": "2024-01-01" }, "upper_limit": 1.86, "value": 1.14 }, "emergency_visits_after_discharge": { "availability_code": "001", "category": "As Expected", "lower_limit": 0.57, "patients": 148, "period": { "end": "2024-12-31", "start": "2023-01-01" }, "upper_limit": 1.6, "value": 1.02 }, "first_year_transplant_waitlist": { "availability_code": "001", "category": "Better than Expected", "lower_limit": 1.26, "patients": 85, "period": { "end": "2023-12-31", "start": "2021-01-01" }, "upper_limit": 3.45, "value": 2.16 }, "fistula": { "availability_code": "001", "category": "As Expected", "lower_limit": 26.7, "patients": 83, "period": null, "upper_limit": 69.6, "value": 48 }, "hospitalization": { "availability_code": "001", "category": "As Expected", "lower_limit": 117.4, "patients": 119, "period": { "end": "2024-12-31", "start": "2024-01-01" }, "upper_limit": 243, "value": 163.8 }, "modality_switch": { "availability_code": "001", "category": "As Expected", "lower_limit": 0.03, "patients": 77, "period": { "end": "2023-12-31", "start": "2021-01-01" }, "upper_limit": 1.02, "value": 0.28 }, "prevalent_transplant_waitlist": { "availability_code": "001", "category": "As Expected", "lower_limit": 15.1, "patients": 120, "period": null, "upper_limit": 46.5, "value": 28.2 }, "readmission": { "availability_code": "001", "category": "As Expected", "lower_limit": 22.1, "patients": 112, "period": { "end": "2024-12-31", "start": "2024-01-01" }, "upper_limit": 42.1, "value": 31.1 }, "survival": { "availability_code": "001", "category": "As Expected", "lower_limit": 10.9, "patients": 501, "period": { "end": "2024-12-31", "start": "2021-01-01" }, "upper_limit": 25.8, "value": 16.5 }, "transfusion": { "availability_code": "001", "category": "Worse than Expected", "lower_limit": 34.8, "patients": 63, "period": { "end": "2024-12-31", "start": "2024-01-01" }, "upper_limit": 110.3, "value": 57.3 } }, "ownership": "Non-profit", "phone": "(507) 266-8733", "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/23ew-n7w9/0?conditions%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&conditions%5B0%5D%5Bvalue%5D=242309&limit=2", "star_rating": 2, "star_rating_availability_code": "001", "star_rating_period": { "end": "2024-12-31", "start": "2021-01-01" }, "state": "MN", "stations": 39, "zip_code": "55905" } ``` ### Home health agencies - Capability: `clinician-procedure-volume/home_health_agencies` - Description: Search CMS Home Health Care Compare agencies by state, city, ZIP, name or quality of patient care star rating. Each result carries the CCN, address, ownership, certification date and the half-star quality of patient care rating with CMS's footnote when unrated. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - Instructions: Find Medicare-certified home health agencies and their CMS quality star ratings. Use home_health_agency with a CCN for services offered and individual measures. - Cost: 5 credits per call - Capability file: [Home health agencies](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/home_health_agencies) Accepted options: - `city` (string): City name, exact match, case-insensitive. Example: `` - `limit` (number): Results per page. Example: `25` - `name` (string): Case-insensitive substring of the home health agency name. Example: `` - `offset` (number): Results to skip; pass next_offset from the previous page. Example: `0` - `star_rating` (number): Only agencies with exactly this star rating (half stars allowed). Example: `5` - `state` (string): Two-letter USPS state or territory code. Pattern: ^[A-Za-z]{2}$. Example: `` - `zip_code` (string): Five-digit ZIP code, exact match. Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "limit": 25, "next_offset": null, "offset": 0, "results": [ { "address": "2746 SUPERIOR DR NW SUITE 200", "ccn": "247161", "certification_date": "1984-04-25", "city": "ROCHESTER", "name": "COMFORT HEALTH", "ownership": "PROPRIETARY", "phone": "5072812332", "star_rating": 2, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" }, { "address": "1800 HIGH POINTE LANE NW, SUITE 250", "ccn": "247180", "certification_date": "1985-01-25", "city": "ROCHESTER", "name": "STANLEY JONES AND ASSOCIATES", "ownership": "NON-PROFIT", "phone": "5072880064", "star_rating": 3, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" }, { "address": "3900 FAIRWAY PLACE NW", "ccn": "248078", "certification_date": "2002-06-03", "city": "ROCHESTER", "name": "INTERNATIONAL QUALITY HOMECARE", "ownership": "PROPRIETARY", "phone": "8889954742", "star_rating": 2, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" }, { "address": "3428 LAKERIDGE PL NW, STE 115", "ccn": "248098", "certification_date": "2006-09-29", "city": "ROCHESTER", "name": "AVEANNA HOME HEALTH", "ownership": "PROPRIETARY", "phone": "5072822246", "star_rating": 4, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" }, { "address": "2222 18TH AVENUE NW, SUITE 210", "ccn": "248153", "certification_date": "2018-12-14", "city": "ROCHESTER", "name": "INTERIM HEALTHCARE OF ROCHESTER", "ownership": "PROPRIETARY", "phone": "5072001111", "star_rating": 3, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/6jpm-sxkc/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=MN&conditions%5B1%5D%5Bproperty%5D=citytown&conditions%5B1%5D%5Bvalue%5D=Rochester&sorts%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&sorts%5B0%5D%5Border%5D=asc&limit=25&offset=0", "total": 5 } ``` ### Home health agency - Capability: `clinician-procedure-volume/home_health_agency` - Description: Return one CMS Home Health Care Compare agency by CCN: identity, ownership, services offered, quality of patient care star rating, twelve OASIS patient-care measures with numerators and denominators, three claims-based risk-standardized outcomes and Medicare spending per episode. - Instructions: Look up a home health agency's CMS star rating, services and quality measures. Get the CCN from home_health_agencies. - Cost: 5 credits per call - Capability file: [Home health agency](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/home_health_agency) Accepted options: - `ccn` (string, required): Six-character CMS Certification Number (CCN), as returned by the matching search function. Pattern: ^[0-9A-Za-z]{6}$. Example: `` Response schema example: ```json { "address": "1800 HIGH POINTE LANE NW, SUITE 250", "ccn": "247180", "certification_date": "1985-01-25", "city": "ROCHESTER", "claims_measures": { "discharge_to_community": { "denominator": 148, "footnote": null, "lower_limit": 90.04, "numerator": 131, "observed_rate": 88.51, "performance": "Better Than National Rate", "risk_standardized_rate": 95.9, "upper_limit": 100.17 }, "potentially_preventable_hospitalization": { "denominator": 65, "footnote": null, "lower_limit": 4.79, "numerator": 3, "observed_rate": 4.62, "performance": "Same As National Rate", "risk_standardized_rate": 8.46, "upper_limit": 13.65 }, "potentially_preventable_readmission": { "denominator": 106, "footnote": null, "lower_limit": 3.02, "numerator": 3, "observed_rate": 2.83, "performance": "Same As National Rate", "risk_standardized_rate": 3.98, "upper_limit": 5.53 } }, "medicare_spending_per_episode": { "episodes": 176, "footnote": null, "ratio_to_national": 0.9 }, "name": "STANLEY JONES AND ASSOCIATES", "ownership": "NON-PROFIT", "phone": "5072880064", "quality_measures": { "bathing_improved": { "denominator": 67, "footnote": null, "numerator": 58, "value": 91.71 }, "bed_transfer_improved": { "denominator": 67, "footnote": null, "numerator": 60, "value": 89.47 }, "breathing_improved": { "denominator": 51, "footnote": null, "numerator": 45, "value": 90.15 }, "discharge_function_score": { "denominator": 68, "footnote": null, "numerator": 57, "value": 83.82 }, "falls_with_major_injury": { "denominator": 78, "footnote": null, "numerator": 0, "value": 0 }, "health_info_to_patient": { "denominator": 60, "footnote": null, "numerator": 46, "value": 76.67 }, "health_info_to_provider": { "denominator": null, "footnote": "The number of patient episodes for this measure is too small to report.", "numerator": null, "value": null }, "medication_issues_addressed": { "denominator": 79, "footnote": null, "numerator": 75, "value": 94.94 }, "oral_medications_improved": { "denominator": 64, "footnote": null, "numerator": 50, "value": 80.72 }, "pressure_ulcers_worsened": { "denominator": 69, "footnote": null, "numerator": 1, "value": 1.57 }, "timely_start_of_care": { "denominator": 79, "footnote": null, "numerator": 48, "value": 60.76 }, "walking_improved": { "denominator": 67, "footnote": null, "numerator": 56, "value": 84.94 } }, "services": { "home_health_aide": false, "medical_social": false, "nursing": true, "occupational_therapy": true, "physical_therapy": true, "speech_pathology": false }, "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/6jpm-sxkc/0?conditions%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&conditions%5B0%5D%5Bvalue%5D=247180&limit=2", "star_rating": 3, "star_rating_footnote": null, "state": "MN", "zip_code": "55901" } ``` ### Hospital - Capability: `clinician-procedure-volume/hospital` - Description: Return one CMS Care Compare hospital by CCN: identity, type, ownership, emergency services, Birthing-Friendly designation, Overall Hospital Quality Star Rating with footnote, and the mortality, safety, readmission, patient experience and timely-and-effective-care measure-group counts behind it. - Instructions: Look up a hospital's CMS star rating and how many of its measures are better, no different or worse than national rates. Get the CCN from hospitals. - Cost: 5 credits per call - Capability file: [Hospital](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/hospital) Accepted options: - `ccn` (string, required): Six-character CMS Certification Number (CCN), as returned by the matching search function. Pattern: ^[0-9A-Za-z]{6}$. Example: `` Response schema example: ```json { "address": "1216 SECOND STREET SOUTHWEST", "birthing_friendly": true, "ccn": "240010", "city": "ROCHESTER", "county": "OLMSTED", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "measure_groups": { "mortality": { "better": 6, "facility_measures": 8, "footnote": null, "measures_in_group": 8, "no_different": 2, "worse": 0 }, "patient_experience": { "facility_measures": 15, "footnote": null, "measures_in_group": 15 }, "readmission": { "better": 4, "facility_measures": 11, "footnote": null, "measures_in_group": 11, "no_different": 7, "worse": 0 }, "safety_of_care": { "better": 6, "facility_measures": 8, "footnote": null, "measures_in_group": 8, "no_different": 2, "worse": 0 }, "timely_and_effective_care": { "facility_measures": 9, "footnote": null, "measures_in_group": 10 } }, "name": "MAYO CLINIC HOSPITAL ROCHESTER", "overall_rating": 5, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Church", "phone": "(507) 255-5123", "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/xubh-q36u/0?conditions%5B0%5D%5Bproperty%5D=facility_id&conditions%5B0%5D%5Bvalue%5D=240010&limit=2", "state": "MN", "zip_code": "55902" } ``` ### Hospitals - Capability: `clinician-procedure-volume/hospitals` - Description: Search CMS Care Compare hospitals (Hospital General Information) by state, city, ZIP, name or overall star rating. Each result carries the CCN, address, hospital type, ownership, emergency services and the Overall Hospital Quality Star Rating. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - Instructions: Find Medicare-certified hospitals and their CMS overall star ratings. Use hospital with a CCN for measure-group detail. Star ratings summarize CMS quality measures; they are not clinical outcome guarantees. - Cost: 5 credits per call - Capability file: [Hospitals](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/hospitals) Accepted options: - `city` (string): City name, exact match, case-insensitive. Example: `` - `limit` (number): Results per page. Example: `25` - `name` (string): Case-insensitive substring of the hospital name. Example: `` - `offset` (number): Results to skip; pass next_offset from the previous page. Example: `0` - `star_rating` (number): Only facilities with exactly this star rating. Example: `1` - `state` (string): Two-letter USPS state or territory code. Pattern: ^[A-Za-z]{2}$. Example: `` - `zip_code` (string): Five-digit ZIP code, exact match. Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "limit": 25, "next_offset": null, "offset": 0, "results": [ { "address": "1216 SECOND STREET SOUTHWEST", "ccn": "240010", "city": "ROCHESTER", "county": "OLMSTED", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "name": "MAYO CLINIC HOSPITAL ROCHESTER", "overall_rating": 5, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Church", "phone": "(507) 255-5123", "state": "MN", "zip_code": "55902" }, { "address": "701 HEWITT BOULEVARD", "ccn": "240018", "city": "RED WING", "county": "GOODHUE", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM IN RED WING", "overall_rating": 4, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Private", "phone": "(651) 267-5000", "state": "MN", "zip_code": "55066" }, { "address": "404 WEST FOUNTAIN STREET", "ccn": "240043", "city": "ALBERT LEA", "county": "FREEBORN", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - ALBERT LEA AND AUSTIN", "overall_rating": 5, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Private", "phone": "(507) 377-6490", "state": "MN", "zip_code": "56007" }, { "address": "1025 MARSH STREET", "ccn": "240093", "city": "MANKATO", "county": "BLUE EARTH", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - MANKATO", "overall_rating": 5, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Private", "phone": "(507) 625-4031", "state": "MN", "zip_code": "56002" }, { "address": "800 MEDICAL CENTER DRIVE", "ccn": "240166", "city": "FAIRMONT", "county": "MARTIN", "emergency_services": true, "hospital_type": "Acute Care Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - FAIRMONT", "overall_rating": 5, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Private", "phone": "(507) 238-5064", "state": "MN", "zip_code": "56031" }, { "address": "1101 MOULTON AND PARSONS DRIVE", "ccn": "241333", "city": "ST JAMES", "county": "WATONWAN", "emergency_services": true, "hospital_type": "Critical Access Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM ST. JAMES", "overall_rating": null, "overall_rating_footnote": "16", "ownership": "Voluntary non-profit - Private", "phone": "(507) 375-8602", "state": "MN", "zip_code": "56081" }, { "address": "500 WEST GRANT STREET", "ccn": "241338", "city": "LAKE CITY", "county": "WABASHA", "emergency_services": true, "hospital_type": "Critical Access Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - LAKE CITY", "overall_rating": null, "overall_rating_footnote": "16", "ownership": "Voluntary non-profit - Private", "phone": "(651) 345-5955", "state": "MN", "zip_code": "55041" }, { "address": "501 NORTH STATE STREET", "ccn": "241345", "city": "WASECA", "county": "WASECA", "emergency_services": true, "hospital_type": "Critical Access Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - WASECA", "overall_rating": null, "overall_rating_footnote": "16", "ownership": "Voluntary non-profit - Private", "phone": "(507) 835-1210", "state": "MN", "zip_code": "56093" }, { "address": "32021 COUNTY 24 BOULEVARD", "ccn": "241346", "city": "CANNON FALLS", "county": "GOODHUE", "emergency_services": true, "hospital_type": "Critical Access Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM - CANNON FALLS", "overall_rating": null, "overall_rating_footnote": "16", "ownership": "Voluntary non-profit - Private", "phone": "(507) 263-6000", "state": "MN", "zip_code": "55009" }, { "address": "301 2ND STREET NORTHEAST", "ccn": "241361", "city": "NEW PRAGUE", "county": "SCOTT", "emergency_services": true, "hospital_type": "Critical Access Hospitals", "name": "MAYO CLINIC HEALTH SYSTEM NEW PRAGUE", "overall_rating": 2, "overall_rating_footnote": null, "ownership": "Voluntary non-profit - Private", "phone": "(952) 758-4431", "state": "MN", "zip_code": "56071" } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/xubh-q36u/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=MN&conditions%5B1%5D%5Bproperty%5D=facility_name&conditions%5B1%5D%5Bvalue%5D=%25mayo+clinic%25&conditions%5B1%5D%5Boperator%5D=like&sorts%5B0%5D%5Bproperty%5D=facility_id&sorts%5B0%5D%5Border%5D=asc&limit=25&offset=0", "total": 10 } ``` ### Nursing home - Capability: `clinician-procedure-volume/nursing_home` - Description: Return one CMS Nursing Home Care Compare provider by CCN: identity, ownership and chain, all six star ratings with footnotes, payroll-based staffing hours and turnover, latest inspection results, fines and payment denials, coordinates and the CMS processing date. - Instructions: Look up a nursing home's CMS ratings, staffing, inspections and penalties. Get the CCN from nursing_homes. Penalties cover the last three years as published by CMS. - Cost: 5 credits per call - Capability file: [Nursing home](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/nursing_home) Accepted options: - `ccn` (string, required): Six-character CMS Certification Number (CCN), as returned by the matching search function. Pattern: ^[0-9A-Za-z]{6}$. Example: `` Response schema example: ```json { "abuse_icon": false, "address": "4001 19TH AVENUE NORTHWEST", "average_residents_per_day": 57.2, "ccn": "245153", "certified_beds": 62, "chain": { "average_health_inspection_rating": 2.5, "average_overall_rating": 2.8, "average_quality_measure_rating": 2.9, "average_staffing_rating": 4, "facility_count": 23, "id": "75", "name": "BENEDICTINE HEALTH SYSTEM" }, "changed_ownership_last_12_months": false, "city": "ROCHESTER", "continuing_care_retirement_community": true, "county": "Olmsted", "first_approved_date": "1968-03-14", "health_inspection_rating": 3, "inside_hospital": false, "inspections": { "infection_control_citations": null, "last_cycle_health_deficiencies": 2, "last_standard_survey_date": "2026-04-23", "last_survey_over_two_years_ago": false, "total_weighted_health_survey_score": 41 }, "latitude": 44.0642, "legal_business_name": "MADONNA TOWERS OF ROCHESTER, INC", "long_stay_quality_measure_rating": 2, "longitude": -92.493, "name": "MADONNA TOWERS OF ROCHESTER", "overall_rating": 3, "ownership_type": "Non profit - Corporation", "penalties": { "fines": 1, "fines_total_usd": 10196, "payment_denials": 0, "total_penalties": 1 }, "phone": "5072883911", "processing_date": "2026-08-01", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 3, "rating_footnotes": { "health_inspection": null, "long_stay_quality_measures": null, "overall": null, "quality_measures": null, "short_stay_quality_measures": null, "staffing": null }, "short_stay_quality_measure_rating": 4, "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/4pq5-n9py/0?conditions%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&conditions%5B0%5D%5Bvalue%5D=245153&limit=2", "special_focus_status": null, "staffing": { "administrators_departed": 1, "case_mix_adjusted_total_nurse_hours_per_resident_day": 4.66687, "lpn_hours_per_resident_day": 0.54073, "nurse_aide_hours_per_resident_day": 2.3751, "physical_therapist_hours_per_resident_day": 0.13396, "rn_hours_per_resident_day": 1.05716, "rn_turnover_pct": 60, "total_nurse_hours_per_resident_day": 3.97298, "total_nursing_staff_turnover_pct": 60.5, "weekend_total_nurse_hours_per_resident_day": 3.4773 }, "staffing_rating": 4, "state": "MN", "urban": true, "zip_code": "55901" } ``` ### Nursing homes - Capability: `clinician-procedure-volume/nursing_homes` - Description: Search CMS Nursing Home Care Compare (Provider Information) by state, city, ZIP, name or overall star rating. Each result carries the CCN, address, ownership, certified beds, the overall, health inspection, quality measure and staffing star ratings, Special Focus Facility status and the abuse icon. Requires at least one of state, city, zip_code or name. Results are ordered by CCN and paginated with offset/next_offset; an explicit zero-match query returns an empty results array. - Instructions: Find Medicare/Medicaid nursing homes and compare their CMS five-star ratings. Use nursing_home with a CCN for staffing, inspection, penalty and chain detail. - Cost: 5 credits per call - Capability file: [Nursing homes](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/nursing_homes) Accepted options: - `city` (string): City name, exact match, case-insensitive. Example: `` - `limit` (number): Results per page. Example: `25` - `name` (string): Case-insensitive substring of the nursing home name. Example: `` - `offset` (number): Results to skip; pass next_offset from the previous page. Example: `0` - `star_rating` (number): Only facilities with exactly this star rating. Example: `1` - `state` (string): Two-letter USPS state or territory code. Pattern: ^[A-Za-z]{2}$. Example: `` - `zip_code` (string): Five-digit ZIP code, exact match. Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "limit": 25, "next_offset": null, "offset": 0, "results": [ { "abuse_icon": false, "address": "4001 19TH AVENUE NORTHWEST", "ccn": "245153", "certified_beds": 62, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 3, "name": "MADONNA TOWERS OF ROCHESTER", "overall_rating": 3, "ownership_type": "Non profit - Corporation", "phone": "5072883911", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 3, "special_focus_status": null, "staffing_rating": 4, "state": "MN", "zip_code": "55901" }, { "abuse_icon": false, "address": "501 EIGHTH AVENUE SOUTHEAST", "ccn": "245184", "certified_beds": 85, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 1, "name": "ROCHESTER RESTORATIVE CARE CENTER", "overall_rating": 1, "ownership_type": "For profit - Corporation", "phone": "5072886514", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 2, "special_focus_status": null, "staffing_rating": 4, "state": "MN", "zip_code": "55904" }, { "abuse_icon": false, "address": "211 NORTHWEST SECOND STREET", "ccn": "245282", "certified_beds": 32, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 4, "name": "CHARTER HOUSE INC", "overall_rating": 5, "ownership_type": "Non profit - Corporation", "phone": "5072667862", "provider_type": "Medicare", "quality_measure_rating": 5, "special_focus_status": null, "staffing_rating": 5, "state": "MN", "zip_code": "55901" }, { "abuse_icon": false, "address": "2215 HIGHWAY 52 NORTH", "ccn": "245306", "certified_beds": 48, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 1, "name": "EDENBROOK ROCHESTER WEST", "overall_rating": 2, "ownership_type": "For profit - Limited Liability company", "phone": "5072881818", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 3, "special_focus_status": null, "staffing_rating": 5, "state": "MN", "zip_code": "55901" }, { "abuse_icon": false, "address": "1875 19TH STREET NORTHWEST", "ccn": "245409", "certified_beds": 81, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 2, "name": "EDENBROOK OF ROCHESTER", "overall_rating": 2, "ownership_type": "For profit - Corporation", "phone": "5072829449", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 4, "special_focus_status": null, "staffing_rating": 4, "state": "MN", "zip_code": "55901" }, { "abuse_icon": false, "address": "24 8TH STREET NORTHWEST", "ccn": "245530", "certified_beds": 128, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 3, "name": "SAMARITAN BETHANY HOME ON EIGHTH", "overall_rating": 3, "ownership_type": "Non profit - Corporation", "phone": "5072894031", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 3, "special_focus_status": null, "staffing_rating": 4, "state": "MN", "zip_code": "55901" }, { "abuse_icon": false, "address": "1900 BALLINGTON BOULEVARD NW", "ccn": "245626", "certified_beds": 56, "city": "ROCHESTER", "county": "Olmsted", "health_inspection_rating": 1, "name": "ROCHESTER REHABILITATION AND LIVING CENTER", "overall_rating": 1, "ownership_type": "Non profit - Corporation", "phone": "5073225555", "provider_type": "Medicare and Medicaid", "quality_measure_rating": 2, "special_focus_status": null, "staffing_rating": 4, "state": "MN", "zip_code": "55901" } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/4pq5-n9py/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=MN&conditions%5B1%5D%5Bproperty%5D=citytown&conditions%5B1%5D%5Bvalue%5D=Rochester&sorts%5B0%5D%5Bproperty%5D=cms_certification_number_ccn&sorts%5B0%5D%5Border%5D=asc&limit=25&offset=0", "total": 7 } ``` ### Utilization - Capability: `clinician-procedure-volume/utilization` - Description: Return public CMS procedure-volume rows by clinician NPI, including suppressed 1-10 counts as inclusive bounds, volume percentile where reported, and profile display indicator. Some public rows are marked N by CMS and should not appear on clinician profiles; filter displayed_on_profile for profile-facing use. The recent 12-month Medicare observation window has a three-month claims-processing lag; exact measurement dates are not supplied by this API. - Instructions: Look up a clinician's reported Medicare procedure occurrences, not unique patients, quality or outcomes. Check displayed_on_profile before showing profile-facing results; CMS does not give a reason for an N flag. Use the separate NPI Registry program for clinician identity. - Cost: 5 credits per call - Capability file: [Utilization](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/clinician-procedure-volume/utilization) Accepted options: - `npi` (string, required): Ten-digit National Provider Identifier for one clinician. Pattern: ^[12][0-9]{9}$. Example: `` Response schema example: ```json { "npi": "1003000639", "procedures": [ { "category": "Coronary artery bypass graft (CABG)", "count": 22, "count_max": 22, "count_min": 22, "count_reported": "22", "displayed_on_profile": true, "ind_pac_id": "8527252766", "volume_percentile": 71 } ], "source_url": "https://data.cms.gov/provider-data/api/1/datastore/query/n0yb-util/0?conditions%5B0%5D%5Bproperty%5D=npi&conditions%5B0%5D%5Bvalue%5D=1003000639&limit=1500" } ``` ### Drug spending datasets - Capability: `drug-spending/drug_spending_datasets` - Description: Catalogue of the six Medicare and Medicaid Spending by Drug datasets on data.cms.gov (Part D, Part B and Medicaid annual spending by drug; quarterly Part D and Part B; Part D Prescribers by Geography and Drug): stable dataset uuid, current version uuid and label, catalogue `modified` date, reporting periods, row and column counts, CSV URL, size and publisher SHA-1, attachments, and every published version with its row count. Read from the slug resolver, dataset-resources, data-viewer metadata and the Drupal JSON:API version list; four to five requests per dataset. - Instructions: Discover which drug spending datasets exist, their ids, current version and coverage before calling source_status, records_list or records_get. Pass `dataset` to catalogue one dataset cheaply. - Cost: 5 credits per call - Capability file: [Drug spending datasets](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/drug_spending_datasets) Accepted options: - `dataset` (string): Dataset key: part_d_annual (Medicare Part D Spending by Drug), part_d_quarterly (Medicare Quarterly Part D Spending by Drug), part_b_annual (Medicare Part B Spending by Drug), part_b_quarterly (Medicare Quarterly Part B Spending by Drug), medicaid_annual (Medicaid Spending by Drug), part_d_geography (Medicare Part D Prescribers - by Geography and Drug). Example: `part_d_annual` Response schema example: ```json { "count": 1, "datasets": [ { "api_url": "https://data.cms.gov/data-api/v1/dataset/7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b/data", "attachments": [ { "bytes": 298226, "name": "Medicare Part D Spending by Drug Data Dictionary 2024", "url": "https://data.cms.gov/sites/default/files/2026-06/Medicare%20Part%20D%20Spending%20by%20Drug%20Data%20Dictionary%2020260603_508.pdf" }, { "bytes": 191996, "name": "Medicare Part D Spending by Drug Methodology", "url": "https://data.cms.gov/sites/default/files/2026-06/d7e0a571-9d08-40ec-8278-1b2300f59424/DSD_PTD_RY26_20260603_Methodology_WDDSE_508.pdf" }, { "bytes": 54762695, "name": "Medicare Part D Spending by Drug- Excel Reports including Historical Data 2024", "url": "https://data.cms.gov/sites/default/files/2026-06/Medicare%20Part%20D%20Spending%20by%20Drug-Excel%20Reports%20including%20Historical%20Data%20RY26.zip" } ], "cadence": "annual", "column_count": 46, "columns": [ "Brnd_Name", "Gnrc_Name", "Tot_Mftr", "Mftr_Name", "Tot_Spndng_2020", "Tot_Dsg_Unts_2020", "Tot_Clms_2020", "Tot_Benes_2020", "Avg_Spnd_Per_Dsg_Unt_Wghtd_2020", "Avg_Spnd_Per_Clm_2020", "Avg_Spnd_Per_Bene_2020", "Outlier_Flag_2020", "Tot_Spndng_2021", "Tot_Dsg_Unts_2021", "Tot_Clms_2021", "Tot_Benes_2021", "Avg_Spnd_Per_Dsg_Unt_Wghtd_2021", "Avg_Spnd_Per_Clm_2021", "Avg_Spnd_Per_Bene_2021", "Outlier_Flag_2021", "Tot_Spndng_2022", "Tot_Dsg_Unts_2022", "Tot_Clms_2022", "Tot_Benes_2022", "Avg_Spnd_Per_Dsg_Unt_Wghtd_2022", "Avg_Spnd_Per_Clm_2022", "Avg_Spnd_Per_Bene_2022", "Outlier_Flag_2022", "Tot_Spndng_2023", "Tot_Dsg_Unts_2023", "Tot_Clms_2023", "Tot_Benes_2023", "Avg_Spnd_Per_Dsg_Unt_Wghtd_2023", "Avg_Spnd_Per_Clm_2023", "Avg_Spnd_Per_Bene_2023", "Outlier_Flag_2023", "Tot_Spndng_2024", "Tot_Dsg_Unts_2024", "Tot_Clms_2024", "Tot_Benes_2024", "Avg_Spnd_Per_Dsg_Unt_Wghtd_2024", "Avg_Spnd_Per_Clm_2024", "Avg_Spnd_Per_Bene_2024", "Outlier_Flag_2024", "Chg_Avg_Spnd_Per_Dsg_Unt_23_24", "CAGR_Avg_Spnd_Per_Dsg_Unt_20_24" ], "csv_bytes": 5326806, "csv_modified_at": "2026-06-09T15:14:23Z", "csv_sha1": "08c444a0025124026f6e5812b9cb13fe3194796a", "csv_url": "https://data.cms.gov/sites/default/files/2026-06/98218f98-166c-4723-8438-c344a4ef96a6/DSD_PTD_RY26_P04_V10_DY24_BGM.csv", "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "import_status": "OK", "key_columns": [ "Brnd_Name", "Gnrc_Name", "Mftr_Name" ], "modified": "2026-06-25", "name": "Medicare Part D Spending by Drug", "page_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "periods": [ "2020", "2021", "2022", "2023", "2024" ], "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "record_count": 14536, "version": "2024-01-01", "versions": [ { "columns": 46, "last_updated": "2026-06-25", "rows": 14536, "version": "2024-01-01", "version_uuid": "da5ff50b-e5da-42de-b68b-6cfac1f64f35" } ] } ], "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "observed_at_ms": 1792358654936, "retrieved_at": "2026-10-18T21:24:14Z", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug" } ``` ### Records get - Capability: `drug-spending/records_get` - Description: One drug spending record by its source_record_id (dataset key plus key columns, plus the period for annual and quarterly datasets), read with an exact `filter[Col]=` query against the current release. Same record shape as records_list. - Instructions: Re-read one record returned by records_list, or look up a known drug/manufacturer/year such as `part_d_annual|Eliquis|Apixaban|Overall|2024`. Unknown ids are not_found; malformed ids are invalid_input. - Cost: 5 credits per call - Capability file: [Records get](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/records_get) Accepted options: - `source_record_id` (string, required): `||`: `part_d_annual|Brnd_Name|Gnrc_Name|Mftr_Name|YYYY`, `part_b_annual|HCPCS_Cd|Brnd_Name|YYYY`, `medicaid_annual|Brnd_Name|Gnrc_Name|Mftr_Name|YYYY`, `part_d_quarterly|Brnd_Name|Gnrc_Name|Mftr_Name|Year label`, `part_b_quarterly|HCPCS_Cd|Brnd_Name|Year label`, `part_d_geography|Prscrbr_Geo_Lvl|Prscrbr_Geo_Cd|Brnd_Name|Gnrc_Name` (code empty for National). Values exactly as CMS spells them, case-sensitive. Example: `||` Response schema example: ```json { "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "observed_at_ms": 1792358647572, "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "published_at": "2026-06-25", "record": { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 49.082629108, "avg_spending_per_claim": 27.657671958, "avg_spending_per_dosage_unit": 0.2059251004, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": -0.013806371, "change_avg_spending_per_dosage_unit_prior_year": -0.093487366, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2024", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:07Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2024", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 213, "total_claims": 378, "total_dosage_units": 50740, "total_prescribers": null, "total_spending": 10454.6 }, "retrieved_at": "2026-10-18T21:24:07Z", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "version": "2024-01-01" } ``` ### Records list - Capability: `drug-spending/records_list` - Description: Full current contents of one drug spending dataset, in pages of up to 5000 source rows read from the data API (`/dataset/{version}/data?size=&offset=`), addressed by the pinned version uuid. Annual rows are unpivoted to one record per restated year (five records per source row); quarterly and geography rows map one to one. The cursor pins the version uuid and the publisher's CSV SHA-1; every page re-reads both and fails with invalid_input at /continuation (issue code `publication_changed`) when the release moved, instead of mixing releases. Each record carries source_record_id, source_url, publication_id and retrieved_at. Spending is gross of rebates. - Instructions: Collect every row of a dataset. Start without `continuation`, then pass `meta.page.next_cursor` until `has_more` is false. No `records/changes` exists: CMS publishes no deltas or modified-since filter (each release restates the file), so diff snapshots downstream. - Cost: 5 credits per call - Capability file: [Records list](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/records_list) Accepted options: - `continuation` (string): Opaque cursor from the previous page's meta.page.next_cursor (also derivable from next_offset). Pins the release; a moved release fails with publication_changed. Example: `` - `dataset` (string, required): Dataset key: part_d_annual (Medicare Part D Spending by Drug), part_d_quarterly (Medicare Quarterly Part D Spending by Drug), part_b_annual (Medicare Part B Spending by Drug), part_b_quarterly (Medicare Quarterly Part B Spending by Drug), medicaid_annual (Medicaid Spending by Drug), part_d_geography (Medicare Part D Prescribers - by Geography and Drug). Example: `part_d_annual` - `page_size` (number): Source rows per page (default 1000, maximum 5000: the API silently caps larger sizes). Annual pages yield five records per row. Example: `10` Response schema example: ```json { "content_hash": "08c444a0025124026f6e5812b9cb13fe3194796a", "count": 10, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "has_more": true, "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "next_offset": 2, "observed_at_ms": 1792358640369, "offset": 0, "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "published_at": "2026-06-25", "records": [ { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 74.560025078, "avg_spending_per_claim": 26.682351357, "avg_spending_per_dosage_unit": 0.217701046, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2020", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2020", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1595, "total_claims": 4457, "total_dosage_units": 547006, "total_prescribers": null, "total_spending": 118923.24 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 77.898522468, "avg_spending_per_claim": 27.583807983, "avg_spending_per_dosage_unit": 0.2230012539, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2021", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2021", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1313, "total_claims": 3708, "total_dosage_units": 459384, "total_prescribers": null, "total_spending": 102280.76 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 61.063304272, "avg_spending_per_claim": 28.004642143, "avg_spending_per_dosage_unit": 0.225873987, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2022", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2022", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1147, "total_claims": 2501, "total_dosage_units": 310304, "total_prescribers": null, "total_spending": 70039.61 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 63.454992847, "avg_spending_per_claim": 27.498474892, "avg_spending_per_dosage_unit": 0.2271618646, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2023", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2023", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 699, "total_claims": 1613, "total_dosage_units": 195672, "total_prescribers": null, "total_spending": 44355.04 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 49.082629108, "avg_spending_per_claim": 27.657671958, "avg_spending_per_dosage_unit": 0.2059251004, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": -0.013806371, "change_avg_spending_per_dosage_unit_prior_year": -0.093487366, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Overall", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2024", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Overall|2024", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Overall", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 213, "total_claims": 378, "total_dosage_units": 50740, "total_prescribers": null, "total_spending": 10454.6 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 74.560025078, "avg_spending_per_claim": 26.682351357, "avg_spending_per_dosage_unit": 0.217701046, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Owen Mumford Us", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2020", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Owen Mumford Us|2020", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Owen%20Mumford%20Us", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1595, "total_claims": 4457, "total_dosage_units": 547006, "total_prescribers": null, "total_spending": 118923.24 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 77.898522468, "avg_spending_per_claim": 27.583807983, "avg_spending_per_dosage_unit": 0.2230012539, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Owen Mumford Us", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2021", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Owen Mumford Us|2021", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Owen%20Mumford%20Us", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1313, "total_claims": 3708, "total_dosage_units": 459384, "total_prescribers": null, "total_spending": 102280.76 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 61.063304272, "avg_spending_per_claim": 28.004642143, "avg_spending_per_dosage_unit": 0.225873987, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Owen Mumford Us", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2022", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Owen Mumford Us|2022", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Owen%20Mumford%20Us", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 1147, "total_claims": 2501, "total_dosage_units": 310304, "total_prescribers": null, "total_spending": 70039.61 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 63.454992847, "avg_spending_per_claim": 27.498474892, "avg_spending_per_dosage_unit": 0.2271618646, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": null, "change_avg_spending_per_dosage_unit_prior_year": null, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Owen Mumford Us", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2023", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Owen Mumford Us|2023", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Owen%20Mumford%20Us", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 699, "total_claims": 1613, "total_dosage_units": 195672, "total_prescribers": null, "total_spending": 44355.04 }, { "antibiotic_drug": null, "antipsychotic_drug": null, "avg_asp_price": null, "avg_spending_per_beneficiary": 49.082629108, "avg_spending_per_claim": 27.657671958, "avg_spending_per_dosage_unit": 0.2059251004, "brand_name": "1st Tier Unifine Pentips", "cagr_avg_spending_per_dosage_unit": -0.013806371, "change_avg_spending_per_dosage_unit_prior_year": -0.093487366, "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "drug_uses": null, "ge65_beneficiary_suppression_flag": null, "ge65_suppression_flag": null, "ge65_total_30day_fills": null, "ge65_total_beneficiaries": null, "ge65_total_claims": null, "ge65_total_drug_cost": null, "generic_name": "Pen Needle, Diabetic", "geography_code": null, "geography_level": null, "geography_name": null, "hcpcs_code": null, "hcpcs_description": null, "lis_beneficiary_cost_share": null, "manufacturer_count": 1, "manufacturer_name": "Owen Mumford Us", "non_lis_beneficiary_cost_share": null, "opioid_drug": null, "opioid_long_acting_drug": null, "outlier_flag": false, "period": "2024", "period_kind": "year", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "retrieved_at": "2026-10-18T21:24:00Z", "source_record_id": "part_d_annual|1st Tier Unifine Pentips|Pen Needle, Diabetic|Owen Mumford Us|2024", "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=50&filter%5BBrnd_Name%5D=1st%20Tier%20Unifine%20Pentips&filter%5BGnrc_Name%5D=Pen%20Needle%2C%20Diabetic&filter%5BMftr_Name%5D=Owen%20Mumford%20Us", "spending_basis": "gross_of_rebates", "total_30day_fills": null, "total_beneficiaries": 213, "total_claims": 378, "total_dosage_units": 50740, "total_prescribers": null, "total_spending": 10454.6 } ], "retrieved_at": "2026-10-18T21:24:00Z", "rows": 2, "source_url": "https://data.cms.gov/data-api/v1/dataset/da5ff50b-e5da-42de-b68b-6cfac1f64f35/data?size=2&offset=0", "total_rows": 14536, "version": "2024-01-01" } ``` ### Search - Capability: `drug-spending/search` - Description: Look up what Medicare and Medicaid spend on a drug, from CMS's annual Spending by Drug datasets for Medicare Part D (prescriptions patients fill), Medicare Part B (drugs given in clinics and hospital outpatient departments, by HCPCS code) and Medicaid. Matches a brand or generic name, or part of one, case-insensitively (and a HCPCS code for Part B), and returns every matching drug per program with up to five years of total spending, dosage units, claims, beneficiaries (Medicare only), average spending per dosage unit, claim and beneficiary, CMS's outlier flag, the latest-year change and compound annual growth of unit cost, the manufacturers (Part D, Medicaid) and the Part B average sales price. Drugs come largest latest-year spending first; `datasets` gives each program's years, release date and match count. Spending is gross of manufacturer rebates. No match is an empty result. - Instructions: Questions about one drug or a few: "how much did Medicare spend on Eliquis in 2024", "how has Ozempic's cost per dose changed", "what does Medicaid pay for semaglutide", "what does Part B spend on Keytruda (J9271)". Use `top` for the biggest or fastest-growing drugs, and the `records_list` collector only to copy every row of a whole dataset (or the quarterly files) in bulk. - Cost: 5 credits per call - Capability file: [Search](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/search) Accepted options: - `drug` (string, required): Brand or generic name, or part of one (`Eliquis`, `apixaban`, `semaglutide`), or a Part B HCPCS code (`J9271`). Letters, digits, spaces and - / . , ( ) ' + % # &. Example: `` - `limit` (number): Drugs returned per program, largest latest-year spending first. Example: `10` - `program` (string): Search one program; omit to search all three. `part_d`: Medicare Part D, prescriptions patients take themselves. `part_b`: Medicare Part B, drugs given in doctors' offices and hospital outpatient departments, by HCPCS code. `medicaid`: Medicaid outpatient prescriptions. Example: `part_d` Response schema example: ```json { "datasets": [ { "matches": 1, "name": "Medicare Part D Spending by Drug", "program": "part_d", "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ 2020, 2021, 2022, 2023, 2024 ] }, { "matches": 0, "name": "Medicare Part B Spending by Drug", "program": "part_b", "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-b-spending-by-drug", "years": [ 2020, 2021, 2022, 2023, 2024 ] }, { "matches": 1, "name": "Medicaid Spending by Drug", "program": "medicaid", "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicaid-spending-by-drug", "years": [ 2020, 2021, 2022, 2023, 2024 ] } ], "drug": "eliquis", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug, Medicare Part B Spending by Drug and Medicaid Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "results": [ { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 5.1, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -1.1, "to_year": 2024 }, "brand_name": "Eliquis", "generic_name": "Apixaban", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "BMS Primarycare" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4695.1157126, "avg_spending_per_claim": 863.41559248, "avg_spending_per_dosage_unit": 9.6370356894, "outlier": false, "total_beneficiaries": 4424796, "total_claims": 24061332, "total_dosage_units": 2156238528.8, "total_spending": 20774929225, "year": 2024 }, { "avg_spending_per_beneficiary": 4652.2808335, "avg_spending_per_claim": 862.14023496, "avg_spending_per_dosage_unit": 9.7446967132, "outlier": false, "total_beneficiaries": 3927848, "total_claims": 21195452, "total_dosage_units": 1875283428.8, "total_spending": 18273451967, "year": 2023 }, { "avg_spending_per_beneficiary": 4342.1385763, "avg_spending_per_claim": 802.18096265, "avg_spending_per_dosage_unit": 9.1171846791, "outlier": false, "total_beneficiaries": 3505142, "total_claims": 18973041, "total_dosage_units": 1669476768.2, "total_spending": 15219812294, "year": 2022 }, { "avg_spending_per_beneficiary": 4023.9346462, "avg_spending_per_claim": 739.02768778, "avg_spending_per_dosage_unit": 8.5084511016, "outlier": false, "total_beneficiaries": 3125087, "total_claims": 17015798, "total_dosage_units": 1478137928.5, "total_spending": 12575145852, "year": 2021 }, { "avg_spending_per_beneficiary": 3760.8976937, "avg_spending_per_claim": 669.22715743, "avg_spending_per_dosage_unit": 7.8975887451, "outlier": false, "total_beneficiaries": 2641941, "total_claims": 14847081, "total_dosage_units": 1258380589.3, "total_spending": 9936069813.8, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 5.49, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": 5.64, "to_year": 2024 }, "brand_name": "Eliquis", "generic_name": "Apixaban", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "BMS Primarycare" ], "name_note": null, "program": "medicaid", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicaid-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": null, "avg_spending_per_claim": 632.40259013, "avg_spending_per_dosage_unit": 9.561806611, "outlier": false, "total_beneficiaries": null, "total_claims": 2047559, "total_dosage_units": 135434306.51, "total_spending": 1294881615, "year": 2024 }, { "avg_spending_per_beneficiary": null, "avg_spending_per_claim": 596.81280477, "avg_spending_per_dosage_unit": 9.0508945439, "outlier": false, "total_beneficiaries": null, "total_claims": 1967346, "total_dosage_units": 129750425.52, "total_spending": 1174137284.2, "year": 2023 }, { "avg_spending_per_beneficiary": null, "avg_spending_per_claim": 562.20577489, "avg_spending_per_dosage_unit": 8.6454946542, "outlier": false, "total_beneficiaries": null, "total_claims": 1822454, "total_dosage_units": 118557616.81, "total_spending": 1024594163.3, "year": 2022 }, { "avg_spending_per_beneficiary": null, "avg_spending_per_claim": 517.1299915, "avg_spending_per_dosage_unit": 8.1513108407, "outlier": false, "total_beneficiaries": null, "total_claims": 1673542, "total_dosage_units": 106189828.49, "total_spending": 865438760.24, "year": 2021 }, { "avg_spending_per_beneficiary": null, "avg_spending_per_claim": 473.02877826, "avg_spending_per_dosage_unit": 7.7202158509, "outlier": false, "total_beneficiaries": null, "total_claims": 1247423, "total_dosage_units": 76437224.687, "total_spending": 590066977.66, "year": 2020 } ] } ], "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug" } ``` ### Source status - Capability: `drug-spending/source_status` - Description: Cheap version check for one drug spending dataset: current version uuid (publication id), version label, published date, primary CSV URL and size, the publisher's CSV SHA-1 as content hash, file modification time, row and column counts and import status. Three small requests (slug resolver, dataset-resources, data-viewer metadata); no rows are read. - Instructions: Decide whether a dataset has a new release since the last collection, or hand off the CSV URL, size and hash. Use records_list to read the rows. - Cost: 5 credits per call - Capability file: [Source status](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/source_status) Accepted options: - `dataset` (string, required): Dataset key: part_d_annual (Medicare Part D Spending by Drug), part_d_quarterly (Medicare Quarterly Part D Spending by Drug), part_b_annual (Medicare Part B Spending by Drug), part_b_quarterly (Medicare Quarterly Part B Spending by Drug), medicaid_annual (Medicaid Spending by Drug), part_d_geography (Medicare Part D Prescribers - by Geography and Drug). Example: `part_d_annual` Response schema example: ```json { "column_count": 46, "content_hash": "08c444a0025124026f6e5812b9cb13fe3194796a", "dataset": "part_d_annual", "dataset_uuid": "7e0b4365-fd63-4a29-8f5e-e0ac9f66a81b", "file_bytes": 5326806, "file_modified_at": "2026-06-09T15:14:23Z", "file_name": "DSD_PTD_RY26_P04_V10_DY24_BGM.csv", "file_url": "https://data.cms.gov/sites/default/files/2026-06/98218f98-166c-4723-8438-c344a4ef96a6/DSD_PTD_RY26_P04_V10_DY24_BGM.csv", "hash_source": "publisher_csv_sha1", "import_status": "OK", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "name": "Medicare Part D Spending by Drug", "observed_at_ms": 1792358629915, "page_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "publication_id": "da5ff50b-e5da-42de-b68b-6cfac1f64f35", "published_at": "2026-06-25", "record_count": 14536, "retrieved_at": "2026-10-18T21:23:49Z", "source_url": "https://data.cms.gov/data-api/v1/slug?path=%2Fsummary-statistics-on-use-and-payments%2Fmedicare-medicaid-spending-by-drug%2Fmedicare-part-d-spending-by-drug", "version": "2024-01-01" } ``` ### Top - Capability: `drug-spending/top` - Description: Rank the drugs in one CMS Spending by Drug dataset (Medicare Part D, Medicare Part B or Medicaid) for one year by total spending, claims, beneficiaries, average spending per beneficiary, or the latest-year change in average spending per dosage unit, highest or lowest first, optionally only drugs above a spending floor. Each result is the drug's full record, as in `search`, with its manufacturers. Part D and Medicaid are ranked on their drug-level rows, so a drug counts once however many manufacturers make it. Spending is gross of manufacturer rebates. - Instructions: Questions about the top spenders or movers: "which drugs cost Medicare Part D the most in 2024", "which Part B drugs rose fastest in price per unit", "which drugs with over $1 billion in Part D spending cost the most per patient". Use `search` for a named drug, and the `records_list` collector only to copy a whole dataset in bulk. - Cost: 5 credits per call - Capability file: [Top](https://alexandria.firecrawl.dev/agents/providers/data-cms-gov/drug-spending/top) Accepted options: - `limit` (number): limit Example: `10` - `min_total_spending` (number): Only drugs with at least this total spending in USD in `year`. Example: `10` - `order` (string): `desc` for highest first. Example: `desc` - `program` (string, required): The dataset to rank. `part_d`: Medicare Part D, prescriptions patients take themselves. `part_b`: Medicare Part B, drugs given in doctors' offices and hospital outpatient departments, by HCPCS code. `medicaid`: Medicaid outpatient prescriptions. Example: `part_d` - `sort_by` (string): `total_beneficiaries` and `avg_spending_per_beneficiary` are Medicare only (Medicaid publishes no patient counts). `avg_spending_per_unit_change` ranks the latest year against the year before, so it takes no other `year`; pair it with `min_total_spending` to skip small drugs. Example: `total_spending` - `year` (number): Calendar year to rank; defaults to the latest year in the current release (2024). Years outside the release are invalid_input. Example: `2000` Response schema example: ```json { "datasets": [ { "name": "Medicare Part D Spending by Drug", "program": "part_d", "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ 2020, 2021, 2022, 2023, 2024 ] } ], "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), Medicare Part D Spending by Drug. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://data.cms.gov/about" }, "min_total_spending": null, "order": "desc", "program": "part_d", "results": [ { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 5.1, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -1.1, "to_year": 2024 }, "brand_name": "Eliquis", "generic_name": "Apixaban", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "BMS Primarycare" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4695.1157126, "avg_spending_per_claim": 863.41559248, "avg_spending_per_dosage_unit": 9.6370356894, "outlier": false, "total_beneficiaries": 4424796, "total_claims": 24061332, "total_dosage_units": 2156238528.8, "total_spending": 20774929225, "year": 2024 }, { "avg_spending_per_beneficiary": 4652.2808335, "avg_spending_per_claim": 862.14023496, "avg_spending_per_dosage_unit": 9.7446967132, "outlier": false, "total_beneficiaries": 3927848, "total_claims": 21195452, "total_dosage_units": 1875283428.8, "total_spending": 18273451967, "year": 2023 }, { "avg_spending_per_beneficiary": 4342.1385763, "avg_spending_per_claim": 802.18096265, "avg_spending_per_dosage_unit": 9.1171846791, "outlier": false, "total_beneficiaries": 3505142, "total_claims": 18973041, "total_dosage_units": 1669476768.2, "total_spending": 15219812294, "year": 2022 }, { "avg_spending_per_beneficiary": 4023.9346462, "avg_spending_per_claim": 739.02768778, "avg_spending_per_dosage_unit": 8.5084511016, "outlier": false, "total_beneficiaries": 3125087, "total_claims": 17015798, "total_dosage_units": 1478137928.5, "total_spending": 12575145852, "year": 2021 }, { "avg_spending_per_beneficiary": 3760.8976937, "avg_spending_per_claim": 669.22715743, "avg_spending_per_dosage_unit": 7.8975887451, "outlier": false, "total_beneficiaries": 2641941, "total_claims": 14847081, "total_dosage_units": 1258380589.3, "total_spending": 9936069813.8, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": -8.31, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -13.89, "to_year": 2024 }, "brand_name": "Ozempic", "generic_name": "Semaglutide", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Novo Nordisk" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 6642.451386, "avg_spending_per_claim": 1245.0868524, "avg_spending_per_dosage_unit": 306.47791837, "outlier": false, "total_beneficiaries": 1952637, "total_claims": 10417182, "total_dosage_units": 42324232.836, "total_spending": 12970296347, "year": 2024 }, { "avg_spending_per_beneficiary": 6278.0808014, "avg_spending_per_claim": 1327.0908767, "avg_spending_per_dosage_unit": 355.90270351, "outlier": false, "total_beneficiaries": 1464468, "total_claims": 6927972, "total_dosage_units": 26990261.403, "total_spending": 9194048435.1, "year": 2023 }, { "avg_spending_per_beneficiary": 5931.6153137, "avg_spending_per_claim": 1356.8980076, "avg_spending_per_dosage_unit": 468.24204575, "outlier": false, "total_beneficiaries": 780253, "total_claims": 3410839, "total_dosage_units": 11314543.293, "total_spending": 4628160643.4, "year": 2022 }, { "avg_spending_per_beneficiary": 5716.1983248, "avg_spending_per_claim": 1300.3294593, "avg_spending_per_dosage_unit": 452.72044757, "outlier": false, "total_beneficiaries": 458643, "total_claims": 2016177, "total_dosage_units": 6617457.857, "total_spending": 2621694348.3, "year": 2021 }, { "avg_spending_per_beneficiary": 5398.6355827, "avg_spending_per_claim": 1209.0078273, "avg_spending_per_dosage_unit": 433.66625915, "outlier": false, "total_beneficiaries": 269663, "total_claims": 1204138, "total_dosage_units": 3813091.786, "total_spending": 1455812267.1, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 2.08, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -6.79, "to_year": 2024 }, "brand_name": "Jardiance", "generic_name": "Empagliflozin", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Boehringer Ing." ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4496.4644479, "avg_spending_per_claim": 1005.9566989, "avg_spending_per_dosage_unit": 18.937748413, "outlier": false, "total_beneficiaries": 2543331, "total_claims": 11368280, "total_dosage_units": 604181681.71, "total_spending": 11435997421, "year": 2024 }, { "avg_spending_per_beneficiary": 4695.1802152, "avg_spending_per_claim": 1084.2238462, "avg_spending_per_dosage_unit": 20.317966064, "outlier": false, "total_beneficiaries": 1882768, "total_claims": 8153238, "total_dosage_units": 435253096.37, "total_spending": 8839935063.3, "year": 2023 }, { "avg_spending_per_beneficiary": 4429.5412587, "avg_spending_per_claim": 1035.1066451, "avg_spending_per_dosage_unit": 19.509144336, "outlier": false, "total_beneficiaries": 1321067, "total_claims": 5653254, "total_dosage_units": 300042205.4, "total_spending": 5851720782, "year": 2022 }, { "avg_spending_per_beneficiary": 4223.522876, "avg_spending_per_claim": 976.74279418, "avg_spending_per_dosage_unit": 18.613648578, "outlier": false, "total_beneficiaries": 884516, "total_claims": 3824726, "total_dosage_units": 200735048, "total_spending": 3735773560.2, "year": 2021 }, { "avg_spending_per_beneficiary": 3994.5033906, "avg_spending_per_claim": 887.55916365, "avg_spending_per_dosage_unit": 17.441889267, "outlier": false, "total_beneficiaries": 594859, "total_claims": 2677192, "total_dosage_units": 136246482.5, "total_spending": 2376166292.5, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2022, "percent": -0.27, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -5.22, "to_year": 2024 }, "brand_name": "Mounjaro", "generic_name": "Tirzepatide", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Eli Lilly & Co." ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 7083.699118, "avg_spending_per_claim": 1241.2242654, "avg_spending_per_dosage_unit": 511.63410588, "outlier": false, "total_beneficiaries": 894581, "total_claims": 5105397, "total_dosage_units": 12385379.501, "total_spending": 6336942640.7, "year": 2024 }, { "avg_spending_per_beneficiary": 6378.6197224, "avg_spending_per_claim": 1296.405329, "avg_spending_per_dosage_unit": 539.81748741, "outlier": false, "total_beneficiaries": 370203, "total_claims": 1821486, "total_dosage_units": 4374599.5, "total_spending": 2361384157.1, "year": 2023 }, { "avg_spending_per_beneficiary": 2657.3770769, "avg_spending_per_claim": 1189.4393024, "avg_spending_per_dosage_unit": 514.4236735, "outlier": false, "total_beneficiaries": 54202, "total_claims": 121095, "total_dosage_units": 280012.5, "total_spending": 144035152.32, "year": 2022 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 3.42, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -3.01, "to_year": 2024 }, "brand_name": "Xarelto", "generic_name": "Rivaroxaban", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Janssen Pharm." ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4717.7458005, "avg_spending_per_claim": 935.73598327, "avg_spending_per_dosage_unit": 17.677331878, "outlier": false, "total_beneficiaries": 1321019, "total_claims": 6660246, "total_dosage_units": 360337521.2, "total_spending": 6232231839.7, "year": 2024 }, { "avg_spending_per_beneficiary": 4764.6983741, "avg_spending_per_claim": 948.16549741, "avg_spending_per_dosage_unit": 18.225776573, "outlier": false, "total_beneficiaries": 1324165, "total_claims": 6654162, "total_dosage_units": 353267092.74, "total_spending": 6309246822.6, "year": 2023 }, { "avg_spending_per_beneficiary": 4402.1484611, "avg_spending_per_claim": 884.73159386, "avg_spending_per_dosage_unit": 17.263298038, "outlier": false, "total_beneficiaries": 1311333, "total_claims": 6524784, "total_dosage_units": 340242067.46, "total_spending": 5772682547.9, "year": 2022 }, { "avg_spending_per_beneficiary": 4153.8205355, "avg_spending_per_claim": 809.1233803, "avg_spending_per_dosage_unit": 16.398856338, "outlier": false, "total_beneficiaries": 1258010, "total_claims": 6458283, "total_dosage_units": 322692140.09, "total_spending": 5225547771.9, "year": 2021 }, { "avg_spending_per_beneficiary": 3968.2986204, "avg_spending_per_claim": 724.17829598, "avg_spending_per_dosage_unit": 15.450049371, "outlier": false, "total_beneficiaries": 1184718, "total_claims": 6491930, "total_dosage_units": 307078850.29, "total_spending": 4701314805, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 3.94, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -3.2, "to_year": 2024 }, "brand_name": "Trulicity", "generic_name": "Dulaglutide", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Eli Lilly & Co." ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 6915.2074068, "avg_spending_per_claim": 1266.8887558, "avg_spending_per_dosage_unit": 467.74913984, "outlier": false, "total_beneficiaries": 788716, "total_claims": 4305141, "total_dosage_units": 11660568.203, "total_spending": 5454134725.1, "year": 2024 }, { "avg_spending_per_beneficiary": 7844.4796479, "avg_spending_per_claim": 1385.2198119, "avg_spending_per_dosage_unit": 483.20525328, "outlier": false, "total_beneficiaries": 938731, "total_claims": 5316020, "total_dosage_units": 15240416.417, "total_spending": 7363856224.3, "year": 2023 }, { "avg_spending_per_beneficiary": 7409.6236892, "avg_spending_per_claim": 1350.147613, "avg_spending_per_dosage_unit": 459.0083713, "outlier": false, "total_beneficiaries": 840163, "total_claims": 4610823, "total_dosage_units": 13563197.87, "total_spending": 6225291667.6, "year": 2022 }, { "avg_spending_per_beneficiary": 7083.1031991, "avg_spending_per_claim": 1269.4167308, "avg_spending_per_dosage_unit": 432.42763561, "outlier": false, "total_beneficiaries": 663858, "total_claims": 3704201, "total_dosage_units": 10874597.361, "total_spending": 4702174723.6, "year": 2021 }, { "avg_spending_per_beneficiary": 6605.0567572, "avg_spending_per_claim": 1163.5344697, "avg_spending_per_dosage_unit": 400.68233332, "outlier": false, "total_beneficiaries": 497327, "total_claims": 2823185, "total_dosage_units": 8198995.5, "total_spending": 3284873061.9, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 1.98, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -5.91, "to_year": 2024 }, "brand_name": "Trelegy Ellipta", "generic_name": "Fluticasone/Umeclidin/Vilanter", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Glaxosmithkline" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4172.3881814, "avg_spending_per_claim": 846.98611279, "avg_spending_per_dosage_unit": 10.518825318, "outlier": false, "total_beneficiaries": 1268914, "total_claims": 6250872, "total_dosage_units": 503324683.81, "total_spending": 5294401776.8, "year": 2024 }, { "avg_spending_per_beneficiary": 4241.3441011, "avg_spending_per_claim": 889.40492945, "avg_spending_per_dosage_unit": 11.179466384, "outlier": false, "total_beneficiaries": 1050583, "total_claims": 5009961, "total_dosage_units": 398579165.99, "total_spending": 4455884009.7, "year": 2023 }, { "avg_spending_per_beneficiary": 4004.7075657, "avg_spending_per_claim": 850.64001578, "avg_spending_per_dosage_unit": 10.773613712, "outlier": false, "total_beneficiaries": 834046, "total_claims": 3926585, "total_dosage_units": 310027472.56, "total_spending": 3340110326.4, "year": 2022 }, { "avg_spending_per_beneficiary": 3709.4091866, "avg_spending_per_claim": 807.30737427, "avg_spending_per_dosage_unit": 10.342451445, "outlier": false, "total_beneficiaries": 645157, "total_claims": 2964362, "total_dosage_units": 231390736.95, "total_spending": 2393151302.6, "year": 2021 }, { "avg_spending_per_beneficiary": 3547.5219071, "avg_spending_per_claim": 748.56395872, "avg_spending_per_dosage_unit": 9.724371217, "outlier": false, "total_beneficiaries": 419392, "total_claims": 1987542, "total_dosage_units": 152997274.44, "total_spending": 1487802307.7, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 1.63, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -6.31, "to_year": 2024 }, "brand_name": "Farxiga", "generic_name": "Dapagliflozin Propanediol", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Astrazeneca" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 4168.359809, "avg_spending_per_claim": 938.93124922, "avg_spending_per_dosage_unit": 18.314120983, "outlier": false, "total_beneficiaries": 1269216, "total_claims": 5634650, "total_dosage_units": 288866028.75, "total_spending": 5290548963.4, "year": 2024 }, { "avg_spending_per_beneficiary": 4368.7926231, "avg_spending_per_claim": 1010.0853808, "avg_spending_per_dosage_unit": 19.547871688, "outlier": false, "total_beneficiaries": 993909, "total_claims": 4298827, "total_dosage_units": 222129205, "total_spending": 4342182307.3, "year": 2023 }, { "avg_spending_per_beneficiary": 4046.056903, "avg_spending_per_claim": 969.82852705, "avg_spending_per_dosage_unit": 18.940367626, "outlier": false, "total_beneficiaries": 638800, "total_claims": 2665029, "total_dosage_units": 136459449.99, "total_spending": 2584621149.6, "year": 2022 }, { "avg_spending_per_beneficiary": 3685.5874347, "avg_spending_per_claim": 922.51324672, "avg_spending_per_dosage_unit": 18.185588172, "outlier": false, "total_beneficiaries": 385693, "total_claims": 1540905, "total_dosage_units": 78165576.5, "total_spending": 1421505274.4, "year": 2021 }, { "avg_spending_per_beneficiary": 3799.4408185, "avg_spending_per_claim": 858.37861045, "avg_spending_per_dosage_unit": 17.164984931, "outlier": false, "total_beneficiaries": 193920, "total_claims": 858348, "total_dosage_units": 42924123.5, "total_spending": 736787563.52, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 5.67, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -5.83, "to_year": 2024 }, "brand_name": "Humira(Cf) Pen", "generic_name": "Adalimumab", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Abbvie US LLC", "Cordavis Limite" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 67881.991974, "avg_spending_per_claim": 8828.6199844, "avg_spending_per_dosage_unit": 3531.4236112, "outlier": false, "total_beneficiaries": 63768, "total_claims": 490303, "total_dosage_units": 1229464.94, "total_spending": 4328698864.2, "year": 2024 }, { "avg_spending_per_beneficiary": 71897.520712, "avg_spending_per_claim": 9230.8987909, "avg_spending_per_dosage_unit": 3750.063537, "outlier": false, "total_beneficiaries": 61474, "total_claims": 478808, "total_dosage_units": 1182524.4, "total_spending": 4419828188.3, "year": 2023 }, { "avg_spending_per_beneficiary": 64335.23638, "avg_spending_per_claim": 8428.730243, "avg_spending_per_dosage_unit": 3391.7408903, "outlier": false, "total_beneficiaries": 57418, "total_claims": 438263, "total_dosage_units": 1091537.089, "total_spending": 3694000602.5, "year": 2022 }, { "avg_spending_per_beneficiary": 56751.692954, "avg_spending_per_claim": 7755.616586, "avg_spending_per_dosage_unit": 3093.2777754, "outlier": false, "total_beneficiaries": 51229, "total_claims": 374868, "total_dosage_units": 940477.58, "total_spending": 2907332478.3, "year": 2021 }, { "avg_spending_per_beneficiary": 51158.572467, "avg_spending_per_claim": 7248.5897426, "avg_spending_per_dosage_unit": 2832.1316773, "outlier": false, "total_beneficiaries": 42406, "total_claims": 299290, "total_dosage_units": 766006.2, "total_spending": 2169430424.1, "year": 2020 } ] }, { "average_sales_price": null, "avg_spending_per_unit_cagr": { "from_year": 2020, "percent": 1.85, "to_year": 2024 }, "avg_spending_per_unit_change": { "from_year": 2023, "percent": -2.66, "to_year": 2024 }, "brand_name": "Revlimid", "generic_name": "Lenalidomide", "hcpcs_code": null, "hcpcs_description": null, "manufacturers": [ "Celgene/BMS" ], "name_note": null, "program": "part_d", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "years": [ { "avg_spending_per_beneficiary": 107530.91197, "avg_spending_per_claim": 17426.030721, "avg_spending_per_dosage_unit": 854.82283632, "outlier": false, "total_beneficiaries": 38868, "total_claims": 239843, "total_dosage_units": 4888867, "total_spending": 4179511486.3, "year": 2024 }, { "avg_spending_per_beneficiary": 104412.17271, "avg_spending_per_claim": 17852.358104, "avg_spending_per_dosage_unit": 878.21219633, "outlier": false, "total_beneficiaries": 36967, "total_claims": 216207, "total_dosage_units": 4395154, "total_spending": 3859804788.6, "year": 2023 }, { "avg_spending_per_beneficiary": 130277.4786, "avg_spending_per_claim": 18021.647327, "avg_spending_per_dosage_unit": 883.09617744, "outlier": false, "total_beneficiaries": 45557, "total_claims": 329329, "total_dosage_units": 6720907, "total_spending": 5935051092.4, "year": 2022 }, { "avg_spending_per_beneficiary": 129241.63262, "avg_spending_per_claim": 17117.627191, "avg_spending_per_dosage_unit": 840.17444432, "outlier": false, "total_beneficiaries": 45601, "total_claims": 344297, "total_dosage_units": 7014892, "total_spending": 5893547689, "year": 2021 }, { "avg_spending_per_beneficiary": 122432.40164, "avg_spending_per_claim": 16237.14705, "avg_spending_per_dosage_unit": 794.32802648, "outlier": false, "total_beneficiaries": 43747, "total_claims": 329864, "total_dosage_units": 6742991, "total_spending": 5356050274.6, "year": 2020 } ] } ], "sort_by": "total_spending", "source_updated_at": "2026-06-09", "source_url": "https://data.cms.gov/summary-statistics-on-use-and-payments/medicare-medicaid-spending-by-drug/medicare-part-d-spending-by-drug", "year": 2024 } ```