# HHS API: Search healthcare providers > Finds US healthcare providers by name, place, specialty and provider type in the NPI Registry, with practice contact details and primary taxonomy. Results may include providers with similar names. Unofficial. Not affiliated with or endorsed by HHS. - Page: https://fous.com/methods/npiregistry.cms.hhs.gov/search-providers - Method: `npiregistry.cms.hhs.gov/search_providers`, version 1 - Website: npiregistry.cms.hhs.gov - Returns: name, provider type, primary specialty, NPI number, practice address, phone, license state, active status, registry link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `city` | string | no | `"Cleveland"` | Practice city, for example "Cleveland". Default "". | | `name` | string | yes | `"Cleveland Clinic"` | Person or organization name, for example "John Smith" or "Cleveland Clinic". | | `state` | string | no | `"Ohio"` | US state name or two-letter code, for example "Ohio" or "OH". Default "". | | `specialty` | string | no | | Specialty in plain words, for example "cardiology" or "Family Medicine". Default "". | | `max_results` | integer | no | `3` | Maximum providers to return, for example 20 (up to 200). Default 20. | | `provider_type` | string | no | `"organization"` | Type of provider to find, for example "individual". One of "any", "individual", "organization". Default "any". | ## Output From a run on Oct 23, 2026. Its input: ```json { "city": "Cleveland", "name": "Cleveland Clinic", "state": "Ohio", "max_results": 3, "provider_type": "organization" } ``` Its output: ```json { "providers": [ { "name": "Cleveland Clinic", "phone": "216-444-2136", "active": "yes", "npi_number": "1275791162", "license_state": null, "provider_type": "Organization", "registry_link": "https://npiregistry.cms.hhs.gov/provider-view/1275791162", "practice_address": "9500 Euclid Ave, Department Of Radiology- HB6, Cleveland, OH 44195-0001", "primary_specialty": "General Acute Care Hospital" }, { "name": "Cleveland Clinic", "phone": "216-444-6781", "active": "yes", "npi_number": "1356508964", "license_state": null, "provider_type": "Organization", "registry_link": "https://npiregistry.cms.hhs.gov/provider-view/1356508964", "practice_address": "9500 Euclid Ave, Cleveland, OH 44195-0001", "primary_specialty": "Chronic Disease Hospital" }, { "name": "Cleveland Clinic", "phone": "216-526-5430", "active": "yes", "npi_number": "1336316389", "license_state": null, "provider_type": "Organization", "registry_link": "https://npiregistry.cms.hhs.gov/provider-view/1336316389", "practice_address": "Cleveland Clinic 9500 Euclid Ave H35, Cardiothoracic Surgery,, Cleveland, OH 44195-0001", "primary_specialty": "General Acute Care Hospital" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"npiregistry.cms.hhs.gov/search_providers","input":{"city":"Cleveland","name":"Cleveland Clinic","state":"Ohio","max_results":3,"provider_type":"organization"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find a cardiologist named Patel in Columbus, Ohio with phone number and NPI - Look up organizations called Mercy Health in Ohio in the NPI registry - I need individual family medicine providers in Austin, TX with practice addresses - Search NPI registry for pediatric dentists in Denver, Colorado, up to 50 results - Which providers named Johnson practice orthopedics in Florida, and is their license active? ## Input schema ```json { "type": "object", "required": [ "name" ], "properties": { "city": { "type": "string", "default": "", "description": "Practice city, for example \"Cleveland\"." }, "name": { "type": "string", "minLength": 1, "description": "Person or organization name, for example \"John Smith\" or \"Cleveland Clinic\"." }, "state": { "type": "string", "default": "", "description": "US state name or two-letter code, for example \"Ohio\" or \"OH\"." }, "specialty": { "type": "string", "default": "", "description": "Specialty in plain words, for example \"cardiology\" or \"Family Medicine\"." }, "max_results": { "type": "integer", "default": 20, "maximum": 200, "minimum": 1, "description": "Maximum providers to return, for example 20 (up to 200)." }, "provider_type": { "enum": [ "any", "individual", "organization" ], "type": "string", "default": "any", "description": "Type of provider to find, for example \"individual\"." } } } ``` ## Output schema ```json { "type": "object", "required": [ "providers" ], "properties": { "providers": { "type": "array", "items": { "type": "object", "required": [ "name", "provider_type", "primary_specialty", "npi_number", "practice_address", "phone", "license_state", "active", "registry_link" ], "properties": { "name": { "type": [ "string", "null" ], "description": "Provider name and credentials, if listed." }, "phone": { "type": [ "string", "null" ], "description": "Practice location phone number." }, "active": { "type": [ "string", "null" ], "description": "yes or no according to the NPI record." }, "npi_number": { "type": "string", "description": "National Provider Identifier number." }, "license_state": { "type": [ "string", "null" ], "description": "State of the primary specialty license." }, "provider_type": { "type": "string", "description": "Individual or Organization." }, "registry_link": { "type": "string", "description": "Link to the provider record in the NPI Registry." }, "practice_address": { "type": [ "string", "null" ], "description": "Practice location address." }, "primary_specialty": { "type": [ "string", "null" ], "description": "Primary registered specialty." } } }, "description": "Matching healthcare providers." } } } ``` ## See more - [HHS API: Get provider by NPI](https://fous.com/methods/npiregistry.cms.hhs.gov/get-provider.md): Looks up a provider in the NPI Registry by 10-digit NPI number and returns the public name, specialties, addresses, contact details and registry dates. - [Medicare API: Search nursing homes](https://fous.com/methods/medicare.gov/search-nursing-homes.md): Finds U.S. nursing homes on Medicare Care Compare by name, city and state, or ZIP code. Results include star ratings, ownership, fines from the last three years, and Care Compare links. - [Medicare API: Search hospitals](https://fous.com/methods/medicare.gov/search-hospitals.md): Finds U.S. hospitals by name, city and state, or ZIP code, with Medicare overall and patient survey star ratings, contact details, and Care Compare links. Ratings may be unavailable for some hospitals. - [NHS API: Search nearby services](https://fous.com/methods/nhs.uk/search-nearby-services.md): Find nearby NHS service listings from a UK postcode or town, nearest first. NHS service search covers England; urgent_care returns A&E listings. Hours, patient availability and websites are null when not shown. - [ProPublica API: Search nonprofits by name](https://fous.com/methods/projects.propublica.org/search-nonprofits.md): Finds U.S. nonprofits by organization name, optionally filtered by state and city, with the latest reported revenue and assets. - [NIH API: Search grants](https://fous.com/methods/reporter.nih.gov/search-grants.md): Finds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default. - [NIH API: Search PubMed articles](https://fous.com/methods/pubmed.ncbi.nlm.nih.gov/search-articles.md): Finds PubMed medical and life-science articles by topic, with publication details and free full-text links when PubMed confirms them. - [Thomasnet API: Search suppliers](https://fous.com/methods/thomasnet.com/search-suppliers.md): Finds North American industrial suppliers on Thomasnet for a product or service, optionally narrowed by US state or Canadian province and supplier type, in Thomasnet's public listing order. Certifications come from public certification listings or explicit company-profile claims. - [All HHS methods](https://fous.com/methods/hhs.gov.md)