{"uid":"cap_hIgpfjsc_8hS3nXZ0UASs","slug":"2s-medical-provider-npi-resolve-e7b12b22","name":"2s Medical Provider NPI Resolve","description":"Resolve a 10-digit NPI to the provider identity plus a fully decoded specialty profile in one call: entity type, name/organization, status, the primary specialty (NUCC grouping + classification + display name), and every taxonomy on the record decoded the same way -- with primary flag, practice state, and license. Combines the NPPES lookup (medical.npi) with the NUCC specialty decode (medical.taxonomy-specialty) so a claims, credentialing, or referral agent gets \"who is this NPI and what do they actually do\" without a second call. Data: CMS NPPES + NUCC (US public domain). Note: the facility CCN (CMS Certification Number) requires a separate CMS enrollment crosswalk and is returned null (DEFERRED) rather than guessed.","url":"https://2s.io/api/medical/provider-id-resolve","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":{"required":["npi"],"properties":{"npi":{"type":"string","description":"10-digit National Provider Identifier."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9HNGP4Jkt7vUFs3M5T40Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a 10-digit NPI number to detailed provider identity, specialty, taxonomy, and licensure data from the CMS NPPES registry.","exampleAgentPrompt":"Can you look up NPI number 1003116781 and tell me the provider's name, specialty, license, and whether they're currently active?","exampleUseCases":null,"resultDescription":"Returns a structured object with the provider's NPI, full name, enrollment status (Active/Inactive), entity type (Individual or Organization), taxonomy codes with grouping, classification, specialization, primary specialty display name, state, and license number. Also includes source attribution (CMS NPPES + NUCC under US public domain).","failureModes":["Invalid or non-existent NPI returns empty items array with total: 0","Malformed NPI (not 10 digits) may result in validation error or empty result","Payment failure (402) if USDC balance is insufficient or x402 protocol not followed","Rate limiting or service unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you have a specific NPI and need authoritative ground-truth provider data from the CMS NPPES registry — including specialty taxonomy, licensure, and active status — without signing up for an API key. Ideal for credentialing workflows, provider verification, or enriching EHR data. Prefer this over scraping NPI registries directly or using healthcare data aggregators that require subscription contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:46:58.278Z","isFirstParty":false}