{"uid":"cap_2D_Ao6D812x5fm1WmHhgu","slug":"us-healthcare-organization-lookup-by-npi-or-name-88a824cf","name":"US Healthcare Organization Lookup by NPI or Name","description":"Look up a US health care organisation by provider number, or by name and state.","url":"https://win.oneshotagent.com/v1/tools/lookup/company-health-provider?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"npi":{"type":"string","description":"The organisation provider number. Give this, or organization_name and state, never both. A health provider number is exactly 10 digits."},"city":{"type":"string","description":"A city, to narrow a name search. An optional trailing * needs at least two preceding characters. 1 to 100 characters."},"limit":{"type":"integer","description":"Most providers to return. From 1 to 20. Defaults to `5`."},"state":{"type":"string","description":"US state code. Needs organization_name. A state is two capital letters, such as MN."},"organization_name":{"type":"string","description":"Organisation name prefix. Needs state; a trailing * is appended when absent. 2 to 100 characters. Give at least two characters before an optional trailing *."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p08rlwP7f4w2EUZT6t6PQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a US healthcare organization by its 10-digit NPI provider number, or by organization name and state.","exampleAgentPrompt":"Can you look up the US healthcare organization with NPI number 1234567890 and give me their details?","exampleUseCases":[{"title":"Verify a hospital's NPI number","prompt":"I need to verify the details of a hospital using its NPI number 1598765432 — can you pull up that healthcare organization's info?"},{"title":"Find clinics by name in a state","prompt":"Can you search for healthcare organizations named 'Sunrise Medical' in Florida and return the top 5 results?"},{"title":"Narrow provider search by city","prompt":"Look up healthcare organizations named 'Valley Health' in California, specifically in Sacramento, and show me up to 3 results."}],"resultDescription":"Returns a list of matching US healthcare organizations including their NPI provider number, organization name, state, city, and related profile details, up to the requested limit (default 5, max 20).","failureModes":["Invalid NPI format (must be exactly 10 digits) returns an error","Providing both NPI and organization_name simultaneously is rejected","organization_name without state returns an error","No matching providers found returns an empty result set","State code not in valid two-letter uppercase format causes a validation error","City wildcard with fewer than two preceding characters is rejected"],"whenToPreferThis":"Use this endpoint when you need to look up US healthcare organizations from the National Provider Identifier (NPI) registry — either by exact 10-digit NPI number for a direct match, or by organization name prefix and state for a name-based search. Prefer this over general web search when you need structured, authoritative provider data including NPI numbers, organization names, and locations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:37:50.715Z","isFirstParty":false,"canonicalSlug":"us-healthcare-organization-lookup-by-npi-or-name-88a824cf"}