# CMS NPPES NPI Registry Lookup

> CMS NPPES NPI Registry Lookup is a paid API for AI agents from x402-domain-check.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-13).

Look up US healthcare providers in the CMS NPPES NPI Registry by NPI number, name, organization, specialty, city, state, or ZIP code

## Facts

- Endpoint: GET https://x402-domain-check.vercel.app/providers/npi?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-nppes-npi-registry-lookup-7927b1a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nBqoOkaLquE1jgiL-yOcQ

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 cms-nppes-npi-registry-lookup-7927b1a0
```

Example prompt: Can you look up Dr. Jane Smith in the CMS NPPES NPI registry? She's a cardiologist in Dallas, TX — I need her NPI number, license info, and practice address.

## When to prefer this

Use this endpoint when you need authoritative healthcare provider identity data from the official US government NPI registry, including verifying provider credentials, finding specialty-specific practitioners in a geographic area, or enriching provider records with NPI, taxonomy, license, and address data. Prefer this over general web search when you need structured, reliable data for credentialing, compliance, or directory purposes.

## Known failure modes

- No matching providers found for the given search criteria — returns empty result set
- Invalid NPI format (must be exactly 10 digits) — returns validation error
- Invalid state abbreviation — returns parameter error
- Too broad a search returning too many results — may require additional filters
- NPPES API upstream unavailability — returns service error
- Missing required search parameters — returns error indicating at least one search field is needed

## How this service works

US healthcare provider lookup in the CMS NPPES NPI Registry: by NPI number, or by name/organization, specialty (taxonomy), city, state or ZIP. Returns NPI, individual/organization, name, credential, status, primary and all taxonomies with state license numbers, practice address and phone. Not charged on errors.

## Output

Returns a list of matching provider records from NPPES, each including NPI number, provider type (individual or organization), name, credentials, enrollment status, primary and all associated taxonomy codes with state license numbers, practice address, and phone number. No charge is applied if the request returns an error.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "npi": {
       "type": "string",
       "description": "10-digit NPI"
      },
      "city": {
       "type": "string"
      },
      "type": {
       "enum": [
        "individual",
        "organization"
       ],
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1
      },
      "state": {
       "type": "string",
       "description": "2-letter state"
      },
      "taxonomy": {
       "type": "string",
       "description": "NUCC taxonomy description, e.g. Cardiovascular Disease (trailing * wildcard ok, e.g. cardio*)"
      },
      "last_name": {
       "type": "string"
      },
      "first_name": {
       "type": "string"
      },
      "postal_code": {
       "type": "string"
      },
      "organization": {
       "type": "string",
       "description": "Organization name (trailing * wildcard allowed)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-nppes-npi-registry-lookup-7927b1a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-domain-check.vercel.app](https://www.zero.xyz/host/x402-domain-check.vercel.app/llms.txt)
