---
type: "firecrawl-provider"
description: "NPI-keyed procedure volume from the CMS Doctors and Clinicians utilization dataset. Counts of 1-10 are reported as intervals; percentiles rank procedure volume, not outcomes."
use_when: "NPI-keyed procedure volume from the CMS Doctors and Clinicians utilization dataset. Counts of 1-10 are reported as intervals; percentiles rank procedure volume, not outcomes."
categories: "Health"
capabilities: 1
credits_per_call: 5
---
# CMS Doctors and Clinicians Utilization on Firecrawl Alexandria

NPI-keyed procedure volume from the CMS Doctors and Clinicians utilization dataset. Counts of 1-10 are reported as intervals; percentiles rank procedure volume, not outcomes.

- Categories: Health
- Category index: [Health category](https://firecrawl.dev/alexandria/agents/categories/health)
- Provider key: `data-cms-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/data-cms-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-cms-gov/openapi.json)

## 1. Choose this provider when

NPI-keyed procedure volume from the CMS Doctors and Clinicians utilization dataset. Counts of 1-10 are reported as intervals; percentiles rank procedure volume, not outcomes.

## 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/utilization",
  "options": {
    "npi": "1003000639"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `npi` (string, required): Ten-digit National Provider Identifier for one clinician. Pattern: ^[12][0-9]{9}$. Example: `<npi>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "data-cms-gov",
    capability: "clinician-procedure-volume/utilization",
    options: {
      npi: "1003000639",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "data-cms-gov",
  "capability": "clinician-procedure-volume/utilization",
  "options": {
    "npi": "1003000639"
  }
})
```

### 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/utilization",
    "options": {
      "npi": "1003000639"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'data-cms-gov/clinician-procedure-volume/utilization' \
  --options '{"npi":"1003000639"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "data-cms-gov",
  "capability": "clinician-procedure-volume/utilization",
  "options": {
    "npi": "1003000639"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "data-cms-gov",
  "capability": "clinician-procedure-volume/utilization",
  "options": {
    "npi": "1003000639"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```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"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### 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://firecrawl.dev/alexandria/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: `<npi>`

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"
}
```