{"uid":"cap_G2MMFBiHpq-PUV5hKM-yY","slug":"npi-registry-lookup-cms-national-provider-identifier-search-0bd30b95","name":"NPI Registry Lookup — CMS National Provider Identifier Search","description":"Look up US healthcare providers in the CMS NPPES registry — the authoritative directory of National Provider Identifiers (NPIs). Give an exact 10-digit NPI, or search by provider last name (+ optional first name), or organization name, optionally narrowed by state and taxonomy/specialty. Returns each provider with NPI, entity type (individual vs organization), status, name/credential/gender or organization name, sole-proprietor flag, enumeration + last-updated dates, primary taxonomy, the full taxonomy list (code, description, primary flag, state license), and practice/mailing addresses with phone. Free, public-domain (CMS). The canonical \"who is this NPI / find this provider\" lookup for healthcare, claims, and credentialing agents.","url":"https://2s.io/api/medical/npi","method":"GET","headers":{},"bodySchema":{"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":"Exact 10-digit NPI."},"limit":{"type":"integer","description":"Max providers (1-50, default 10)."},"state":{"type":"string","description":"2-letter state to narrow results."},"lastName":{"type":"string","description":"Provider last name."},"taxonomy":{"type":"string","description":"Taxonomy/specialty description, e.g. \"Cardiology\"."},"firstName":{"type":"string","description":"Provider first name (with lastName)."},"organization":{"type":"string","description":"Organization (NPI-2) name."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00108","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00108/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yHmR-LybLvBpd_wl4yNU-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0027","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up US healthcare providers and organizations by NPI number, name, specialty, or state from the CMS NPI registry","exampleAgentPrompt":"Can you look up the NPI registry entry for Mayo Clinic in Minnesota and give me their NPI number, status, address, and primary taxonomy?","exampleUseCases":[{"title":"Verify doctor's active NPI status","prompt":"I need to verify whether Dr. Sarah Chen, a cardiologist in Texas, has an active NPI number. Can you search the NPI registry by her name and state and confirm her status, credentials, and primary specialty?"},{"title":"Find specialists by state and specialty","prompt":"Can you search the CMS NPI registry for all licensed nurse practitioners in Colorado and give me their names, NPI numbers, addresses, and contact information?"},{"title":"Resolve NPI to provider identity","prompt":"I have this NPI number — 1234567890 — on a claims form and I need to know who it belongs to. Can you look it up in the NPI registry and tell me the provider's name, specialty, address, and whether the NPI is still active?"}],"resultDescription":"Returns a list of matching provider records from the CMS NPI registry, each including the 10-digit NPI, entity type (individual or organization), active status, name, addresses with phone and fax, taxonomies with specialty descriptions and license numbers, enumeration date, and last updated date. Also returns total match count and data source attribution.","failureModes":["Invalid or non-existent NPI returns empty items array with total=0","Ambiguous name search with no state filter may return too many results (capped at limit)","NPI must be exactly 10 digits — malformed NPI returns error or empty result","Missing required search parameter returns error","Rate limit or payment failure returns HTTP 402"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced NPI data directly from the CMS NPPES registry — ideal for verifying provider credentials, looking up healthcare provider addresses and specialties, or resolving NPI numbers to provider identities. Prefer this over third-party provider directories when accuracy and public-record provenance matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:17.729Z","isFirstParty":false}