# CMS NPPES NPI Registry Lookup

> CMS NPPES NPI Registry Lookup is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the CMS NPPES NPI Registry for individual US healthcare providers (NPI-1) by last name and state, returning NPI number, credentials, taxonomy, and practice location.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/npi-registry?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-nppes-npi-registry-lookup-6831cad1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gQgbfIRdwjE-fgvJoSL-A

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-6831cad1
```

Example prompt: Can you look up NPI records for a provider with last name 'Rodriguez' in Texas? I need their NPI number, credentials, and primary taxonomy — show me up to 10 results.

## When to prefer this

Use this endpoint when you need to look up individual US healthcare provider NPI records (NPI type 1 only) by name and state from the official CMS NPPES registry. Prefer this over general web search when you need structured, authoritative NPI data including credentials, taxonomy codes, and practice locations. Not suitable for organizational/group NPI-2 lookups or lookups by NPI number directly.

## Known failure modes

- No matching providers found for the given last name and state combination — returns empty providers array
- State code not a valid 2-letter US code — may return error or empty result
- Last name shorter than 2 or longer than 40 characters — schema validation failure
- Limit parameter outside 1-20 range — may be ignored or cause error
- CMS NPPES upstream API downtime — may return error or stale data

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the query parameters, source URL, timestamp, total result count, and an array of matching individual providers each with: NPI number, status (A=active), last name, first name, credential, primary taxonomy, practice city, practice state, and last updated date.

## 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": [
      "lastName",
      "state"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Records to return, 1 to 20 (default 5)"
      },
      "state": {
       "type": "string",
       "description": "2-letter US state code, e.g. CA"
      },
      "lastName": {
       "type": "string",
       "description": "Provider last name, 2 to 40 letters"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "state": "CA",
   "lastName": "Smith"
  },
  "source": "https://npiregistry.cms.hhs.gov/api/",
  "checkedAt": "2026-10-23T09:37:15.755Z",
  "providers": [
   {
    "npi": "1104130236",
    "status": "A",
    "lastName": "AKEY",
    "firstName": "SHELLEY",
    "credential": "RN, NNP",
    "lastUpdated": "2025-03-03",
    "practiceCity": "PHOENIX",
    "practiceState": "AZ",
    "primaryTaxonomy": "Nurse Practitioner, Neonatal"
   },
   {
    "npi": "1700442894",
    "status": "A",
    "lastName": "ALIOTO",
    "firstName": "KATHERYN",
    "credential": null,
    "lastUpdated": "2019-11-19",
    "practiceCity": "EL CAJON",
    "practiceState": "CA",
    "primaryTaxonomy": "Counselor, Addiction (Substance Use Disorder)"
   }
  ],
  "resultCount": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-nppes-npi-registry-lookup-6831cad1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)