# 2s.io Medicare Provider Utilization & Payments Lookup

> 2s.io Medicare Provider Utilization & Payments Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.00288/call, status unknown (last checked 2026-09-14).

Look up CMS Medicare utilization and payment data for a specific provider by NPI or filter by last name and state, returning billing statistics, beneficiary demographics, and chronic-condition aggregates.

## Facts

- Endpoint: GET https://2s.io/api/health/medicare-provider
- Price: $0.00288/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-medicare-provider-utilization-payments-lookup-291062d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qrg3sizOrPO_eUnsFtzCp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-medicare-provider-utilization-payments-lookup-291062d3
```

Example prompt: Pull up the CMS Medicare utilization and payment data for NPI 1234567890 — I want to see their total services, Medicare payment amounts, and beneficiary demographics from the latest annual dataset.

## When to prefer this

Use this endpoint when you need structured CMS Medicare billing and utilization data for a specific provider or set of providers — particularly for KYC, healthcare fraud research, provider due diligence, or enriching provider profiles with public payment data. Prefer this over general web search when you need authoritative federal data with standardized CMS column names and demographic/chronic-condition aggregates.

## Known failure modes

- NPI not found in CMS dataset — returns empty result set
- lastName filter is case-sensitive and must match CMS-published name exactly — typos yield no results
- State code must be a valid 2-letter USPS abbreviation — invalid codes return no results
- Pagination offset beyond available records returns empty array
- Payment failure or invalid x402 credentials returns 402 error

## How this service works

Medicare utilization + payments by provider (CMS 'Physician & Other Practitioners - by Provider' annual dataset). Look up by npi, or filter by lastName (exact last/organization name) + state. Each row: provider NPI, name, credentials, entity type, full address, provider type/specialty, Medicare participation, beneficiary counts, total services, submitted charges, Medicare allowed/payment amounts, plus beneficiary demographic + chronic-condition aggregates — CMS's documented column names (Rndrng_NPI, Tot_Srvcs, Tot_Mdcr_Pymt_Amt, etc). Complements /api/health/open-payments (industry payments to the same NPIs). KYC, healthcare-fraud research, and provider due diligence. For a provider 360 (identity + industry payments + this) by NPI in one call, see /api/health/provider-profile. Public-domain federal data.

## Output

Returns one or more provider records from the CMS Physician & Other Practitioners dataset, each including: provider NPI, name, credentials, entity type, full address, specialty/provider type, Medicare participation flag, beneficiary counts, total services rendered, submitted charges, Medicare allowed and payment amounts, and beneficiary demographic and chronic-condition aggregate fields using CMS's official column names (e.g. Rndrng_NPI, Tot_Srvcs, Tot_Mdcr_Pymt_Amt).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 10,
   "state": "CA",
   "offset": 0,
   "lastName": "Smith"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "npi": {
       "type": "string",
       "description": "10-digit provider NPI."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1
      },
      "state": {
       "type": "string",
       "description": "2-letter state code."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      },
      "lastName": {
       "type": "string",
       "description": "Exact last name / organization name (case-sensitive as published by CMS)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-medicare-provider-utilization-payments-lookup-291062d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)