--- type: "firecrawl-provider" description: "CMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution." use_when: "CMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution.\n\nCMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution." categories: "Life sciences" capabilities: 5 credits_per_call: 5 --- # Medicaid open data: SDUD and NADAC on Firecrawl Alexandria CMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution. - Categories: Life sciences - Category index: [Life sciences category](https://firecrawl.dev/alexandria/agents/categories/life-sciences) - Provider key: `data-medicaid-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/data-medicaid-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/openapi.json) ## Capabilities - [Records get](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/records_get): One SDUD or NADAC row by its natural key: SDUD `utilization_type|state|ndc|year|quarter` (e.g. FFSU|AK|00002143380|2025|4), NADAC `ndc|effective_date|as_of_date` (e.g. 00002143380|2026-09-23|2026-10-14). Exactly one datastore row must match; none is not_found. - [Records list](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/records_list): One page of SDUD or NADAC rows for a dataset-year, read from the datastore as sorted 8000-row CSV pages. Without a segment filter the listing walks every segment of the year (SDUD: state x quarter in state order; NADAC: weekly as_of_date ascending); a page never spans two segments. The cursor pins the dataset id, distribution id and DKAN import version: every page re-reads the metastore item and fails with invalid_input at /continuation (issue code publication_changed) when the version moved. - [Source status](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/source_status): Cheap version check of one dataset-year: metastore `modified`, distribution id, DKAN import version (publication id), bulk CSV URL with its size (1-byte Range), ETag and Last-Modified from download.medicaid.gov, the datastore row count and, when a segment is given, that segment's row count. - [History](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/prices/history): Every NADAC rate one NDC has had since NADAC began in November 2013, newest first: each rate's effective date, price and the first and last weekly file that listed it, plus the change from the oldest to the newest rate. `from` and `to` keep only the rates in force at some point in that range. An NDC that no weekly file lists, or with no rate in the range, is `not_found`. - [Search](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/prices/search): Find NADAC per-unit drug acquisition costs by drug name or NDC. Without dates it reads the newest weekly file: each matching NDC's current rate, by description and NDC, with `total_count`. With `effective_from` or `effective_to` it lists the rates that took effect in that range across all years, newest first, which shows price changes. No match is an empty result. ## 1. Choose this provider when CMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution. CMS Medicaid open data (data.medicaid.gov, DKAN): State Drug Utilization Data (Medicaid units, prescriptions and dollars reimbursed by state, NDC and quarter) and NADAC (weekly National Average Drug Acquisition Cost per unit by NDC), collected per dataset-year through the public datastore API under the shared collector contract (source status, pinned paginated listing, single-record lookup). Two agent-facing NADAC functions answer price questions directly: `prices/search` reads the newest weekly file by drug name or NDC (or the rates that took effect in a date range) and `prices/history` returns every rate one NDC has had since 2013, each with CMS attribution. ## 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-medicaid-gov", "capability": "drug-utilization/records_get", "options": { "dataset": "sdud", "id": "FFSU|AK|00002143380|2025|4", "year": 2025 } } ``` ## 3. Add provider options Use only the options needed for the task: - `dataset` (string, required): sdud = State Drug Utilization Data (one dataset per year, 1991 onwards); nadac = NADAC (National Average Drug Acquisition Cost), one dataset per year, 2013 onwards. Example: `sdud` - `id` (string, required): The natural key joined with `|` (the record's source_record_id). Example: `|` - `year` (number, required): Calendar year of the dataset; resolved to its dataset id through the catalogue title. Example: `1991` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-medicaid-gov", capability: "drug-utilization/records_get", options: { dataset: "sdud", id: "FFSU|AK|00002143380|2025|4", year: 2025, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-medicaid-gov", "capability": "drug-utilization/records_get", "options": { "dataset": "sdud", "id": "FFSU|AK|00002143380|2025|4", "year": 2025 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-medicaid-gov", "capability": "drug-utilization/records_get", "options": { "dataset": "sdud", "id": "FFSU|AK|00002143380|2025|4", "year": 2025 } } }' ``` ### CLI ```sh firecrawl scrape 'data-medicaid-gov/drug-utilization/records_get' \ --options '{"dataset":"sdud","id":"FFSU|AK|00002143380|2025|4","year":2025}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-medicaid-gov", "capability": "drug-utilization/records_get", "options": { "dataset": "sdud", "id": "FFSU|AK|00002143380|2025|4", "year": 2025 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-medicaid-gov", "capability": "drug-utilization/records_get", "options": { "dataset": "sdud", "id": "FFSU|AK|00002143380|2025|4", "year": 2025 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "dataset": "sdud", "dataset_id": "158a1baa-5506-400a-8ec3-97756f0b0536", "distribution_id": "a613f4ae-0615-572c-812a-a381379914cd", "import_version": "1783956571", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), State Drug Utilization Data (SDUD), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "modified": "2026-07-13T15:28:32+00:00", "observed_at_ms": 1792358842029, "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "record": { "labeler_code": "00002", "medicaid_amount_reimbursed": 104889.56, "ndc": "00002143380", "non_medicaid_amount_reimbursed": 1839.62, "number_of_prescriptions": 113, "package_size": "80", "product_code": "1433", "product_name": "TRULICITY ", "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "quarter": 4, "retrieved_at": "2026-10-18T21:27:22Z", "source_record_id": "FFSU|AK|00002143380|2025|4", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143380&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "state": "AK", "suppression_used": false, "total_amount_reimbursed": 106729.18, "units_reimbursed": 226, "utilization_type": "FFSU", "year": 2025 }, "retrieved_at": "2026-10-18T21:27:22Z", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143380&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "title": "State Drug Utilization Data 2025", "year": 2025 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Records get - Capability: `drug-utilization/records_get` - Description: One SDUD or NADAC row by its natural key: SDUD `utilization_type|state|ndc|year|quarter` (e.g. FFSU|AK|00002143380|2025|4), NADAC `ndc|effective_date|as_of_date` (e.g. 00002143380|2026-09-23|2026-10-14). Exactly one datastore row must match; none is not_found. - Instructions: Fetch or re-check a single row from a source_record_id produced by records_list. For an NDC's current NADAC or its price history, use `search` or `history` (prices). - Cost: 5 credits per call - Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/records_get) Accepted options: - `dataset` (string, required): sdud = State Drug Utilization Data (one dataset per year, 1991 onwards); nadac = NADAC (National Average Drug Acquisition Cost), one dataset per year, 2013 onwards. Example: `sdud` - `id` (string, required): The natural key joined with `|` (the record's source_record_id). Example: `|` - `year` (number, required): Calendar year of the dataset; resolved to its dataset id through the catalogue title. Example: `1991` Response schema example: ```json { "dataset": "sdud", "dataset_id": "158a1baa-5506-400a-8ec3-97756f0b0536", "distribution_id": "a613f4ae-0615-572c-812a-a381379914cd", "import_version": "1783956571", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), State Drug Utilization Data (SDUD), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "modified": "2026-07-13T15:28:32+00:00", "observed_at_ms": 1792358842029, "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "record": { "labeler_code": "00002", "medicaid_amount_reimbursed": 104889.56, "ndc": "00002143380", "non_medicaid_amount_reimbursed": 1839.62, "number_of_prescriptions": 113, "package_size": "80", "product_code": "1433", "product_name": "TRULICITY ", "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "quarter": 4, "retrieved_at": "2026-10-18T21:27:22Z", "source_record_id": "FFSU|AK|00002143380|2025|4", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143380&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "state": "AK", "suppression_used": false, "total_amount_reimbursed": 106729.18, "units_reimbursed": 226, "utilization_type": "FFSU", "year": 2025 }, "retrieved_at": "2026-10-18T21:27:22Z", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143380&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "title": "State Drug Utilization Data 2025", "year": 2025 } ``` ### Records list - Capability: `drug-utilization/records_list` - Description: One page of SDUD or NADAC rows for a dataset-year, read from the datastore as sorted 8000-row CSV pages. Without a segment filter the listing walks every segment of the year (SDUD: state x quarter in state order; NADAC: weekly as_of_date ascending); a page never spans two segments. The cursor pins the dataset id, distribution id and DKAN import version: every page re-reads the metastore item and fails with invalid_input at /continuation (issue code publication_changed) when the version moved. - Instructions: Collect the full current SDUD {year} or NADAC {year} table, or one state/quarter or one weekly as_of_date of it, page by page via meta.page.next_cursor. For a price question about one drug or NDC, use `search` or `history` (prices) instead. - Cost: 5 credits per call - Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/records_list) Accepted options: - `as_of_date` (string): NADAC only: weekly as_of_date (YYYY-MM-DD, Wednesdays). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `continuation` (string): Opaque cursor from the previous page's meta.page.next_cursor. `dataset` and `year` must match the cursor; segment filters are taken from the cursor. Example: `` - `dataset` (string, required): sdud = State Drug Utilization Data (one dataset per year, 1991 onwards); nadac = NADAC (National Average Drug Acquisition Cost), one dataset per year, 2013 onwards. Example: `sdud` - `page_size` (number): Rows per page (default 8000, the datastore maximum). Example: `10` - `quarter` (number): SDUD only: calendar quarter. Example: `4` - `state` (string): SDUD only: two-letter state code as published (AK..WY, DC, PR, and XX for the national total). Pattern: ^[A-Z]{2}$. Example: `` - `year` (number, required): Calendar year of the dataset; resolved to its dataset id through the catalogue title. Example: `1991` Response schema example: ```json { "count": 3, "dataset": "sdud", "dataset_id": "158a1baa-5506-400a-8ec3-97756f0b0536", "distribution_id": "a613f4ae-0615-572c-812a-a381379914cd", "has_more": true, "import_version": "1783956571", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), State Drug Utilization Data (SDUD), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "modified": "2026-07-13T15:28:32+00:00", "observed_at_ms": 1792358864701, "offset": 0, "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "records": [ { "labeler_code": "00002", "medicaid_amount_reimbursed": 104889.56, "ndc": "00002143380", "non_medicaid_amount_reimbursed": 1839.62, "number_of_prescriptions": 113, "package_size": "80", "product_code": "1433", "product_name": "TRULICITY ", "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "quarter": 4, "retrieved_at": "2026-10-18T21:27:44Z", "source_record_id": "FFSU|AK|00002143380|2025|4", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143380&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "state": "AK", "suppression_used": false, "total_amount_reimbursed": 106729.18, "units_reimbursed": 226, "utilization_type": "FFSU", "year": 2025 }, { "labeler_code": "00002", "medicaid_amount_reimbursed": 136973.47, "ndc": "00002143480", "non_medicaid_amount_reimbursed": 2979.68, "number_of_prescriptions": 147, "package_size": "80", "product_code": "1434", "product_name": "TRULICITY ", "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "quarter": 4, "retrieved_at": "2026-10-18T21:27:44Z", "source_record_id": "FFSU|AK|00002143480|2025|4", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143480&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "state": "AK", "suppression_used": false, "total_amount_reimbursed": 139953.15, "units_reimbursed": 294, "utilization_type": "FFSU", "year": 2025 }, { "labeler_code": "00002", "medicaid_amount_reimbursed": 18076.19, "ndc": "00002143611", "non_medicaid_amount_reimbursed": 0, "number_of_prescriptions": 25, "package_size": "11", "product_code": "1436", "product_name": "EMGALITY P", "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "quarter": 4, "retrieved_at": "2026-10-18T21:27:44Z", "source_record_id": "FFSU|AK|00002143611|2025|4", "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=utilization_type&conditions%5B0%5D%5Bvalue%5D=FFSU&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=state&conditions%5B1%5D%5Bvalue%5D=AK&conditions%5B1%5D%5Boperator%5D=%3D&conditions%5B2%5D%5Bproperty%5D=ndc&conditions%5B2%5D%5Bvalue%5D=00002143611&conditions%5B2%5D%5Boperator%5D=%3D&conditions%5B3%5D%5Bproperty%5D=year&conditions%5B3%5D%5Bvalue%5D=2025&conditions%5B3%5D%5Boperator%5D=%3D&conditions%5B4%5D%5Bproperty%5D=quarter&conditions%5B4%5D%5Bvalue%5D=4&conditions%5B4%5D%5Boperator%5D=%3D&limit=5&count=true&schema=false", "state": "AK", "suppression_used": false, "total_amount_reimbursed": 18076.19, "units_reimbursed": 25, "utilization_type": "FFSU", "year": 2025 } ], "retrieved_at": "2026-10-18T21:27:44Z", "segment": { "as_of_date": null, "key": "AK|4", "quarter": 4, "state": "AK" }, "segment_total": 21772, "segments_remaining": 0, "source_url": "https://data.medicaid.gov/api/1/datastore/query/158a1baa-5506-400a-8ec3-97756f0b0536/0?conditions%5B0%5D%5Bproperty%5D=state&conditions%5B0%5D%5Bvalue%5D=AK&conditions%5B0%5D%5Boperator%5D=%3D&conditions%5B1%5D%5Bproperty%5D=quarter&conditions%5B1%5D%5Bvalue%5D=4&conditions%5B1%5D%5Boperator%5D=%3D&sorts%5B0%5D%5Bproperty%5D=utilization_type&sorts%5B0%5D%5Border%5D=asc&sorts%5B1%5D%5Bproperty%5D=ndc&sorts%5B1%5D%5Border%5D=asc&limit=3&offset=0&count=false&format=csv", "title": "State Drug Utilization Data 2025", "year": 2025 } ``` ### Source status - Capability: `drug-utilization/source_status` - Description: Cheap version check of one dataset-year: metastore `modified`, distribution id, DKAN import version (publication id), bulk CSV URL with its size (1-byte Range), ETag and Last-Modified from download.medicaid.gov, the datastore row count and, when a segment is given, that segment's row count. - Instructions: Before or between collections, to see whether SDUD {year} or NADAC {year} moved since the last snapshot, and to hand off the bulk file URL, size and hash. - Cost: 5 credits per call - Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/drug-utilization/source_status) Accepted options: - `as_of_date` (string): NADAC only: weekly as_of_date (YYYY-MM-DD, Wednesdays). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `dataset` (string, required): sdud = State Drug Utilization Data (one dataset per year, 1991 onwards); nadac = NADAC (National Average Drug Acquisition Cost), one dataset per year, 2013 onwards. Example: `sdud` - `quarter` (number): SDUD only: calendar quarter. Example: `4` - `state` (string): SDUD only: two-letter state code as published (AK..WY, DC, PR, and XX for the national total). Pattern: ^[A-Z]{2}$. Example: `` - `year` (number, required): Calendar year of the dataset; resolved to its dataset id through the catalogue title. Example: `1991` Response schema example: ```json { "content_hash": "61aa45dd82a9fab9c84893907d6429ad", "dataset": "sdud", "dataset_id": "158a1baa-5506-400a-8ec3-97756f0b0536", "distribution_id": "a613f4ae-0615-572c-812a-a381379914cd", "download_url": "https://download.medicaid.gov/data/sdud2025_updatedjuly2026.csv", "download_url_ref": "2fb4a02532c2ac18aaa043dbeed9b3f3__1783956571__source", "etag": "61aa45dd82a9fab9c84893907d6429ad:1783956256.382764", "hash_source": "download_host_etag_md5", "import_version": "1783956571", "last_modified": "2026-07-13T15:24:16Z", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), State Drug Utilization Data (SDUD), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "modified": "2026-07-13T15:28:32+00:00", "observed_at_ms": 1792358848689, "page_limit": 8000, "publication_id": "158a1baa-5506-400a-8ec3-97756f0b0536:1783956571", "published_at": "2026-07-13T15:28:32+00:00", "record_count": 5308547, "retrieved_at": "2026-10-18T21:27:28Z", "segment": { "as_of_date": null, "key": "CA|4", "quarter": 4, "state": "CA" }, "segment_count": 39644, "size_bytes": 508574722, "source_url": "https://data.medicaid.gov/api/1/metastore/schemas/dataset/items/158a1baa-5506-400a-8ec3-97756f0b0536?show-reference-ids", "title": "State Drug Utilization Data 2025", "year": 2025 } ``` ### History - Capability: `prices/history` - Description: Every NADAC rate one NDC has had since NADAC began in November 2013, newest first: each rate's effective date, price and the first and last weekly file that listed it, plus the change from the oldest to the newest rate. `from` and `to` keep only the rates in force at some point in that range. An NDC that no weekly file lists, or with no rate in the range, is `not_found`. - Instructions: Use with an NDC from `search` or from FDA's NDC directory for "how has the acquisition cost of Eliquis 5 mg changed since 2020". It reads every year at once and returns each rate once; `records_get` reads one raw row by its collector key and `records_list` copies whole files. - Cost: 5 credits per call - Capability file: [History](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/prices/history) Accepted options: - `from` (string): Keep only rates still in force on or after this date (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `ndc` (string, required): The NDC: 11 digits (`00003089421`) or hyphenated 5-4-2, 4-4-2, 5-3-2 or 5-4-1 (`0003-0894-21`). A bare 10-digit NDC is ambiguous and rejected. Pattern: ^[0-9]+(-[0-9]+-[0-9]+)?$. Example: `00003089421` - `to` (string): Keep only rates that took effect on or before this date (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "change": { "from_effective_date": "2013-08-30", "from_nadac_per_unit": 4.30924, "percent": 28.13, "to_effective_date": "2026-10-21", "to_nadac_per_unit": 5.52144 }, "classification": "B", "classification_label": "brand", "description": "ELIQUIS 5 MG TABLET", "from": null, "in_latest_file": true, "last_published": "2026-10-28", "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), National Average Drug Acquisition Cost (NADAC), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "ndc": "00003089421", "ndc_5_4_2": "00003-0894-21", "observed_at_ms": 1793382015477, "otc": false, "pricing_unit": "EA", "rates": [ { "classification": "B", "effective_date": "2026-10-21", "first_published": "2026-10-21", "last_published": "2026-10-28", "nadac_per_unit": 5.52144 }, { "classification": "B", "effective_date": "2026-09-23", "first_published": "2026-09-23", "last_published": "2026-10-14", "nadac_per_unit": 5.52114 }, { "classification": "B", "effective_date": "2026-08-19", "first_published": "2026-08-19", "last_published": "2026-09-16", "nadac_per_unit": 5.52106 }, { "classification": "B", "effective_date": "2026-07-22", "first_published": "2026-07-22", "last_published": "2026-08-12", "nadac_per_unit": 5.52277 }, { "classification": "B", "effective_date": "2026-06-17", "first_published": "2026-06-17", "last_published": "2026-07-15", "nadac_per_unit": 5.52276 }, { "classification": "B", "effective_date": "2026-05-20", "first_published": "2026-05-20", "last_published": "2026-06-10", "nadac_per_unit": 5.52374 }, { "classification": "B", "effective_date": "2026-01-01", "first_published": "2026-01-14", "last_published": "2026-05-13", "nadac_per_unit": 5.52654 }, { "classification": "B", "effective_date": "2025-12-17", "first_published": "2025-12-17", "last_published": "2026-01-07", "nadac_per_unit": 9.69551 }, { "classification": "B", "effective_date": "2025-11-19", "first_published": "2025-11-19", "last_published": "2025-12-10", "nadac_per_unit": 9.69413 }, { "classification": "B", "effective_date": "2025-10-22", "first_published": "2025-10-22", "last_published": "2025-11-12", "nadac_per_unit": 9.6937 }, { "classification": "B", "effective_date": "2025-09-17", "first_published": "2025-09-17", "last_published": "2025-10-15", "nadac_per_unit": 9.69127 }, { "classification": "B", "effective_date": "2025-08-20", "first_published": "2025-08-20", "last_published": "2025-09-10", "nadac_per_unit": 9.69127 }, { "classification": "B", "effective_date": "2025-07-23", "first_published": "2025-07-23", "last_published": "2025-08-13", "nadac_per_unit": 9.69129 }, { "classification": "B", "effective_date": "2025-06-18", "first_published": "2025-06-18", "last_published": "2025-07-16", "nadac_per_unit": 9.69011 }, { "classification": "B", "effective_date": "2025-05-21", "first_published": "2025-05-21", "last_published": "2025-06-11", "nadac_per_unit": 9.69113 }, { "classification": "B", "effective_date": "2025-01-01", "first_published": "2025-01-08", "last_published": "2025-05-14", "nadac_per_unit": 9.70084 }, { "classification": "B", "effective_date": "2024-12-18", "first_published": "2024-12-18", "last_published": "2025-01-01", "nadac_per_unit": 9.51063 }, { "classification": "B", "effective_date": "2024-11-20", "first_published": "2024-11-20", "last_published": "2024-12-11", "nadac_per_unit": 9.51084 }, { "classification": "B", "effective_date": "2024-10-23", "first_published": "2024-10-23", "last_published": "2024-11-13", "nadac_per_unit": 9.51156 }, { "classification": "B", "effective_date": "2024-09-18", "first_published": "2024-09-18", "last_published": "2024-10-16", "nadac_per_unit": 9.51193 }, { "classification": "B", "effective_date": "2024-08-21", "first_published": "2024-08-21", "last_published": "2024-09-11", "nadac_per_unit": 9.5139 }, { "classification": "B", "effective_date": "2024-07-17", "first_published": "2024-07-17", "last_published": "2024-08-14", "nadac_per_unit": 9.51325 }, { "classification": "B", "effective_date": "2024-06-19", "first_published": "2024-06-19", "last_published": "2024-07-10", "nadac_per_unit": 9.51282 }, { "classification": "B", "effective_date": "2024-05-22", "first_published": "2024-05-22", "last_published": "2024-06-12", "nadac_per_unit": 9.51479 }, { "classification": "B", "effective_date": "2024-01-01", "first_published": "2024-01-10", "last_published": "2024-05-15", "nadac_per_unit": 9.50366 }, { "classification": "B", "effective_date": "2023-10-18", "first_published": "2023-10-18", "last_published": "2024-01-03", "nadac_per_unit": 8.96563 }, { "classification": "B", "effective_date": "2023-01-01", "first_published": "2023-01-11", "last_published": "2023-10-11", "nadac_per_unit": 8.97238 }, { "classification": "B", "effective_date": "2022-01-01", "first_published": "2022-01-12", "last_published": "2023-01-04", "nadac_per_unit": 8.46451 }, { "classification": "B", "effective_date": "2021-10-20", "first_published": "2021-10-20", "last_published": "2022-01-05", "nadac_per_unit": 7.98546 }, { "classification": "B", "effective_date": "2021-01-01", "first_published": "2021-01-13", "last_published": "2021-10-13", "nadac_per_unit": 7.98423 }, { "classification": "B", "effective_date": "2020-10-21", "first_published": "2020-10-21", "last_published": "2021-01-06", "nadac_per_unit": 7.53229 }, { "classification": "B", "effective_date": "2020-01-01", "first_published": "2020-01-08", "last_published": "2020-10-14", "nadac_per_unit": 7.53546 }, { "classification": "B", "effective_date": "2019-10-23", "first_published": "2019-10-23", "last_published": "2020-01-01", "nadac_per_unit": 7.10892 }, { "classification": "B", "effective_date": "2019-01-01", "first_published": "2019-01-09", "last_published": "2019-10-16", "nadac_per_unit": 7.11193 }, { "classification": "B", "effective_date": "2018-10-17", "first_published": "2018-10-17", "last_published": "2019-01-02", "nadac_per_unit": 6.70937 }, { "classification": "B", "effective_date": "2018-01-01", "first_published": "2018-01-10", "last_published": "2018-10-10", "nadac_per_unit": 6.7086 }, { "classification": "B", "effective_date": "2017-12-20", "first_published": "2017-12-20", "last_published": "2018-01-03", "nadac_per_unit": 6.21742 }, { "classification": "B", "effective_date": "2017-03-22", "first_published": "2017-03-22", "last_published": "2017-12-13", "nadac_per_unit": 6.2116 }, { "classification": "B", "effective_date": "2017-02-22", "first_published": "2017-02-22", "last_published": "2017-03-15", "nadac_per_unit": 6.23089 }, { "classification": "B", "effective_date": "2017-01-01", "first_published": "2017-01-11", "last_published": "2017-02-15", "nadac_per_unit": 6.24973 }, { "classification": "B", "effective_date": "2016-04-01", "first_published": "2016-04-13", "last_published": "2017-01-04", "nadac_per_unit": 5.7922 }, { "classification": "B", "effective_date": "2015-11-18", "first_published": "2015-11-18", "last_published": "2016-04-06", "nadac_per_unit": 5.36817 }, { "classification": "B", "effective_date": "2015-10-21", "first_published": "2015-10-21", "last_published": "2015-11-11", "nadac_per_unit": 5.39851 }, { "classification": "B", "effective_date": "2015-08-24", "first_published": "2015-09-02", "last_published": "2015-10-14", "nadac_per_unit": 5.38368 }, { "classification": "B", "effective_date": "2014-12-15", "first_published": "2014-12-24", "last_published": "2015-08-26", "nadac_per_unit": 5.08378 }, { "classification": "B", "effective_date": "2014-05-21", "first_published": "2014-05-21", "last_published": "2014-12-17", "nadac_per_unit": 4.70725 }, { "classification": "B", "effective_date": "2014-03-17", "first_published": "2014-03-26", "last_published": "2014-05-14", "nadac_per_unit": 4.73581 }, { "classification": "B", "effective_date": "2013-08-30", "first_published": "2013-11-28", "last_published": "2014-03-19", "nadac_per_unit": 4.30924 } ], "source_updated_at": "2026-10-28", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704", "to": null } ``` ### Search - Capability: `prices/search` - Description: Find NADAC per-unit drug acquisition costs by drug name or NDC. Without dates it reads the newest weekly file: each matching NDC's current rate, by description and NDC, with `total_count`. With `effective_from` or `effective_to` it lists the rates that took effect in that range across all years, newest first, which shows price changes. No match is an empty result. - Instructions: Start here for a price question about a drug: "what does a pharmacy pay for Eliquis 5 mg" or "which atorvastatin NDCs changed price this month". Take a result's `ndc` to `history` for its price history since 2013; `ndc` also joins FDA's NDC directory (fda-gov). Use `records_list` instead only to copy a whole weekly NADAC file row by row. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/data-medicaid-gov/prices/search) Accepted options: - `effective_from` (string): List rates that took effect on or after this date (YYYY-MM-DD) instead of reading the newest file. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `effective_to` (string): List rates that took effect on or before this date (YYYY-MM-DD) instead of reading the newest file. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Results per page. Example: `25` - `ndc` (string): One NDC: 11 digits (`00003089421`) or hyphenated 5-4-2, 4-4-2, 5-3-2 or 5-4-1 (`0003-0894-21`). A bare 10-digit NDC is ambiguous and rejected. Pattern: ^[0-9]+(-[0-9]+-[0-9]+)?$. Example: `00003089421` - `offset` (number): `next_offset` from the previous page; repeat the same input with it. Example: `0` - `query` (string): Drug name, optionally with strength and form, matched word by word against the NADAC description: `eliquis`, `eliquis 5 mg`, `atorvastatin 10mg tablet`. A strength matches as written after a space, so `10 mg` does not match `110 MG`. Example: `` Response schema example: ```json { "effective_from": null, "effective_to": null, "license": { "attribution": "Source: Centers for Medicare & Medicaid Services (CMS), National Average Drug Acquisition Cost (NADAC), data.medicaid.gov. Use does not imply CMS endorsement.", "name": "Public domain (U.S. Government work)", "url": "https://www.usa.gov/publicdomain/label/1.0/" }, "limit": 25, "mode": "latest_file", "ndc": null, "next_offset": null, "observed_at_ms": 1793382014265, "offset": 0, "query": "eliquis 5 mg", "results": [ { "classification": "B", "classification_label": "brand", "description": "ELIQUIS 5 MG TABLET", "effective_date": "2026-10-21", "explanation": [ "Calculated from the most recently completed pharmacy survey" ], "explanation_codes": [ 1 ], "generic_effective_date": null, "generic_nadac_per_unit": null, "in_latest_file": true, "last_published": "2026-10-28", "nadac_per_unit": 5.52144, "ndc": "00003089421", "ndc_5_4_2": "00003-0894-21", "otc": false, "pricing_unit": "EA", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704" }, { "classification": "B", "classification_label": "brand", "description": "ELIQUIS 5 MG TABLET", "effective_date": "2026-10-21", "explanation": [ "Calculated from the most recently completed pharmacy survey" ], "explanation_codes": [ 1 ], "generic_effective_date": null, "generic_nadac_per_unit": null, "in_latest_file": true, "last_published": "2026-10-28", "nadac_per_unit": 5.52144, "ndc": "00003089431", "ndc_5_4_2": "00003-0894-31", "otc": false, "pricing_unit": "EA", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704" }, { "classification": "B", "classification_label": "brand", "description": "ELIQUIS 5 MG TABLET", "effective_date": "2026-10-21", "explanation": [ "Calculated from the most recently completed pharmacy survey" ], "explanation_codes": [ 1 ], "generic_effective_date": null, "generic_nadac_per_unit": null, "in_latest_file": true, "last_published": "2026-10-28", "nadac_per_unit": 5.52144, "ndc": "00003089470", "ndc_5_4_2": "00003-0894-70", "otc": false, "pricing_unit": "EA", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704" }, { "classification": "B", "classification_label": "brand", "description": "ELIQUIS DVT-PE TREATMENT 30-DAY STARTER 5 MG PACK", "effective_date": "2026-10-21", "explanation": [ "Calculated from the most recently completed pharmacy survey" ], "explanation_codes": [ 1 ], "generic_effective_date": null, "generic_nadac_per_unit": null, "in_latest_file": true, "last_published": "2026-10-28", "nadac_per_unit": 5.50699, "ndc": "00003376474", "ndc_5_4_2": "00003-3764-74", "otc": false, "pricing_unit": "EA", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704" } ], "source_updated_at": "2026-10-28", "source_url": "https://data.medicaid.gov/dataset/fbb83258-11c7-47f5-8b18-5f8e79f7e704", "total_count": 4 } ```