{"uid":"cap_rdN3Oz24AW5h-gZNiQJ0I","slug":"cms-nppes-npi-registry-provider-search-56212499","name":"CMS NPPES NPI Registry Provider Search","description":"Paid public-data feeds. Unpaid requests return HTTP 402. Prices are USDC on Base.","url":"https://project-api-gamma-sable.vercel.app/paid/cms/nppes?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":["last_name"],"properties":{"npi":{"type":"string","description":"10-digit NPI"},"org":{"type":"string","description":"Query param: org"},"city":{"type":"string","description":"City name"},"skip":{"type":"string","description":"Result skip"},"limit":{"type":"string","description":"Max results"},"state":{"type":"string","description":"US state code (e.g. CA)"},"number":{"type":"string","description":"CPSC recall number (alias of recall)"},"offset":{"type":"string","description":"Result offset"},"last_name":{"type":"string","description":"Query param: last_name"},"first_name":{"type":"string","description":"Query param: first_name"},"postal_code":{"type":"string","description":"Query param: postal_code"},"enumeration_type":{"type":"string","description":"Query param: enumeration_type"},"organization_name":{"type":"string","description":"Query param: organization_name"},"taxonomy_description":{"type":"string","description":"Query param: taxonomy_description"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"what":"CMS NPPES NPI Registry provider search (slim JSON + uiLink)","items":[],"source":"/paid/cms/nppes"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cLtxHZRgCFwZtjbQ6UCGK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 healthcare providers by name, NPI number, organization, location, or taxonomy, returning slim JSON results with a UI link.","exampleAgentPrompt":"Look up healthcare providers in the NPPES NPI registry with last name 'Smith' in California who are listed as Family Medicine — show me up to 10 results.","exampleUseCases":[{"title":"Verify a physician's NPI number","prompt":"Can you search the NPI registry for a Dr. Emily Johnson, a physician in Texas? I need to confirm her NPI number and specialty."},{"title":"Find local specialists by taxonomy","prompt":"Search the NPPES registry for all cardiologists in Chicago, IL — give me up to 20 results with their NPI numbers and organization names."},{"title":"Lookup provider by NPI","prompt":"I have an NPI number 1234567890 — can you pull the provider details from the NPI registry for that specific number?"}],"resultDescription":"Returns a slim JSON object containing a list of matching NPI provider records (items array) sourced from the CMS NPPES registry, along with a uiLink for viewing results in a browser interface. Each item typically includes provider name, NPI number, organization, taxonomy, and location details.","failureModes":["HTTP 402 returned if payment is not included — requires USDC payment on Base","Missing required 'last_name' query parameter returns a validation error","No results returned (empty items array) when no providers match the search criteria","Invalid NPI format (not 10 digits) may return empty or error response","State code not recognized if not a valid two-letter US state abbreviation"],"whenToPreferThis":"Use this endpoint when you need to search or verify US healthcare provider records from the authoritative CMS NPPES NPI Registry, especially for looking up providers by name, NPI number, specialty/taxonomy, or geographic location. Prefer this over general web searches when you need structured, authoritative provider data at low cost ($0.01 USDC per call) with a payment-gated public data feed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:20.629Z","isFirstParty":false,"canonicalSlug":"cms-nppes-npi-registry-provider-search-56212499"}