{"uid":"cap_gQgbfIRdwjE-fgvJoSL-A","slug":"cms-nppes-npi-registry-lookup-6831cad1","name":"CMS NPPES NPI Registry Lookup","description":"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.","url":"https://api.companyrecords-api.workers.dev/api/gov/npi-registry?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NqTSrAumT7Lnp-uUlu7zL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Verify a referring physician's NPI","prompt":"I need to verify Dr. Patel's NPI number — she's a physician in New York. Can you look her up in the NPI registry by last name Patel and state NY and tell me her NPI, credentials, and specialty?"},{"title":"Find an addiction counselor for a referral","prompt":"Can you find licensed addiction counselors with the last name 'Martin' practicing in Florida? Pull their NPI numbers and practice cities from the NPI registry so I can reach out to the right one."},{"title":"Credentialing check for a new hire","prompt":"We're onboarding a new nurse practitioner named Thompson in California. Can you pull her NPI record from the CMS registry — I need her NPI number, credential, taxonomy, and the last time her record was updated?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:45:41.693Z","isFirstParty":false,"canonicalSlug":"cms-nppes-npi-registry-lookup-6831cad1"}