{ "openapi": "3.1.0", "info": { "title": "Healthcare Providers API", "version": "1.0.0", "description": "Look up any of 9.37 million US NPIs with specialties resolved to plain names.\n\nThe complete US healthcare provider registry, self-hosted and queryable: 9.37 million active NPIs from the official CMS NPPES dissemination — 7.4M individual practitioners and 2M organizations — with every specialty code resolved to a human-readable name via the NUCC taxonomy. Look up any 10-digit NPI and get the provider's name, credential (MD, DO, NP...), gender, all taxonomy codes with the primary flagged and named (\"Orthopaedic Surgery Physician\"), practice address with formatted phone, enumeration date and last update. Search by name prefix, last name, state, city, ZIP, taxonomy code, free-text specialty (\"cardiovascular\" finds the right NUCC codes) or entity type — engineered so every filter combination stays index-backed across 9.4M rows. Deactivated NPIs are excluded and removed as CMS deactivates them: the database refreshes daily from the official NPPES weekly incremental files. Includes the full NUCC specialty codebook as its own endpoint. Built for healthtech onboarding, provider directories, claims validation, pharma territory planning and recruiting. Public-domain source data; self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/healthcare-providers.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/healthcare-providers" }, "servers": [ { "url": "https://api-healthcare-providers.dataandapis.com" } ], "tags": [ { "name": "Health", "description": "Healthcare Providers API belongs to the Health category of the Data and APIs catalog." } ], "paths": { "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 2, "sources": [ { "slug": "nppes", "name": "CMS NPPES Data Dissemination (full monthly file)", "publisher": "US Centers for Medicare & Medicaid Services", "licence": "US Government work - public domain", "source_url": "https://download.cms.gov/nppes/NPI_Files.html", "file_url": "https://download.cms.gov/nppes/NPPES_Data_Dissemination_August_2026_V2.zip", "cadence": "monthly full + weekly incrementals", "record_count": 9374927, "retrieved_at": "2026-09-02" }, { "slug": "nucc-taxonomy", "name": "NUCC Health Care Provider Taxonomy", "publisher": "National Uniform Claim Committee", "licence": "Freely available; (c) American Medical Association", "source_url": "https://www.nucc.org/", "file_url": "https://www.nucc.org/images/stories/CSV/nucc_taxonomy_251.csv", "cadence": "twice yearly", "record_count": 883, "retrieved_at": "2026-09-02" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/providers/{npi}": { "get": { "operationId": "getProviderByNpi", "summary": "Get Provider By NPI", "description": "Get Provider By NPI endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/get-provider-by-npi" }, "parameters": [ { "name": "npi", "in": "path", "required": true, "schema": { "type": "string" }, "example": "1679576722" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "provider": { "npi": 1679576722, "entity_type": "individual", "name": "David Wiebe", "first_name": "David", "last_name": "Wiebe", "credential": "M.D.", "gender": "M", "organization_other_name": null, "sole_proprietor": false, "specialty": "Orthopaedic Surgery Physician", "taxonomies": [ { "code": "207X00000X", "primary": true, "specialty": "Orthopaedic Surgery Physician", "grouping": "Allopathic & Osteopathic Physicians" } ], "practice_location": { "street": "3500 Central Ave", "city": "Kearney", "state": "NE", "zip": "68847", "country": "US", "phone": "(308) 865-2512" }, "enumeration_date": "2005-05-23", "last_updated": "2026-07-13" } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/taxonomies/{code}": { "get": { "operationId": "getTaxonomyCode", "summary": "Get Taxonomy Code", "description": "Get Taxonomy Code endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/get-taxonomy-code" }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "example": "207X00000X" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "code": "207X00000X", "grouping": "Allopathic & Osteopathic Physicians", "classification": "Orthopaedic Surgery", "specialization": null, "display_name": "Orthopaedic Surgery Physician", "section": "Individual", "providers_with_primary": 36899 } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/providers/random": { "get": { "operationId": "randomProviders", "summary": "Random Providers", "description": "Random Providers endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/random-providers" }, "parameters": [ { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 1, "results": [ { "npi": 1417000100, "entity_type": "individual", "name": "Alvin Bryan", "first_name": "Alvin", "last_name": "Bryan", "credential": "MD", "gender": "M", "organization_other_name": null, "sole_proprietor": false, "specialty": "Anatomic Pathology & Clinical Pathology Physician", "taxonomies": [ { "code": "207ZP0102X", "primary": true, "specialty": "Anatomic Pathology & Clinical Pathology Physician", "grouping": "Allopathic & Osteopathic Physicians" } ], "practice_location": { "street": "1520 N Leg Rd", "city": "Augusta", "state": "GA", "zip": "30909", "country": "US", "phone": "(706) 869-3121" }, "enumeration_date": "2007-01-18", "last_updated": "2015-08-05" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/providers": { "get": { "operationId": "searchProviders", "summary": "Search Providers", "description": "Search Providers endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/search-providers" }, "parameters": [ { "name": "city", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Rochester" }, { "name": "last_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Mayo Clinic" }, { "name": "specialty", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "example": "MN" }, { "name": "taxonomy", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 24, "page": 1, "limit": 20, "count": 3, "results": [ { "npi": 1083249577, "entity_type": "organization", "name": "Mayo Clinic", "credential": null, "specialty": "Clinical Medical Laboratory", "city": "Rochester", "state": "MN" }, { "npi": 1114343860, "entity_type": "organization", "name": "Mayo Clinic", "credential": null, "specialty": "Infectious Disease Physician", "city": "Rochester", "state": "MN" }, { "npi": 1164758868, "entity_type": "organization", "name": "Mayo Clinic", "credential": null, "specialty": "Community Based Hospice Care Agency", "city": "Rochester", "state": "MN" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/taxonomies": { "get": { "operationId": "searchTaxonomies", "summary": "Search Taxonomies", "description": "Search Taxonomies endpoint of the Healthcare Providers API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/healthcare-providers/search-taxonomies" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "50" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "orthopaedic" }, { "name": "section", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Individual" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 3, "taxonomies": [ { "code": "207X00000X", "grouping": "Allopathic & Osteopathic Physicians", "classification": "Orthopaedic Surgery", "specialization": null, "display_name": "Orthopaedic Surgery Physician", "section": "Individual" }, { "code": "207XS0114X", "grouping": "Allopathic & Osteopathic Physicians", "classification": "Orthopaedic Surgery", "specialization": "Adult Reconstructive Orthopaedic Surgery", "display_name": "Adult Reconstructive Orthopaedic Surgery Physician", "section": "Individual" }, { "code": "207XX0004X", "grouping": "Allopathic & Osteopathic Physicians", "classification": "Orthopaedic Surgery", "specialization": "Foot and Ankle Surgery", "display_name": "Orthopaedic Foot and Ankle Surgery Physician", "section": "Individual" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }