NPI Registry API: US Healthcare Organizations

Find US healthcare organisations (hospitals, clinics, pharmacies, labs, home health agencies, nursing facilities, surgery centres, DME suppliers and more) in the official CMS NPI Registry (NPPES), and get clean, flat B2B records you can drop straight into a CRM, spreadsheet or AI agent.

• Organisations only. Every record is a Type 2 NPI (NPI-2). Individual clinicians (NPI-1) are never returned.
• No personal data. The authorised official's name and direct phone, and endpoint e-mail addresses, are removed. You get the organisation's business address and business phone only.
• Past the 1,200 ceiling. The NPI Registry API stops at 1,200 matches per search. This Actor pages through each search and, when you ask for more, splits big searches by ZIP-code prefix automatically.
• Agent-ready. Flat field names, one record per organisation, de-duplicated by NPI, with source and licence on every record. Works as a tool for AI agents through the Apify MCP server.

Who it is for

• Sales and lead generation for medical devices, pharma, health IT, billing, staffing and B2B services: build lists of pharmacies in Texas, hospitals in Ohio or labs in a ZIP range.
• Data and RevOps teams enriching or verifying an account list against NPI numbers.
• Credentialing, payer and network teams checking organisation NPIs, taxonomies and practice addresses.
• AI agents that need to look up a healthcare organisation by name, place or NPI.

How to use it

Fill in one or more filters. Filters of different kinds are combined (AND); several values in one filter each run as a separate search (OR), and results are de-duplicated.

Input	What it does
organizationNames	Legal name, DBA, former or other name. Matches "starts with" by default (mayo finds MAYO CLINIC).
states	Two-letter codes, e.g. CA. Cannot be the only filter (an NPI Registry rule).
cities	e.g. Boston. Best with a state.
postalCodes	5 or 9 digit ZIPs, or a prefix like 021*.
taxonomyDescriptions	NUCC taxonomy text, e.g. General Acute Care Hospital, Pharmacy, Clinic/Center, Home Health, Skilled Nursing Facility, Ambulatory Surgical, Clinical Medical Laboratory.
npiNumbers	Look up specific 10-digit NPIs. Individual NPIs are skipped.
maxItems	Maximum records to return (default 100, up to 10,000).
addressPurpose	Match state/city/ZIP against any address (default), practice locations, primary location, secondary locations, or mailing address.
autoSplit	Split searches with more than 1,200 matches by ZIP prefix (default on).
includeDeactivated	Return deactivated NPIs too (NPI and status only). Default off.

Example input

{
  "taxonomyDescriptions": ["Pharmacy"],
  "states": ["TX"],
  "cities": ["Austin"],
  "maxItems": 200
}

{
  "npiNumbers": ["1881018208", "1255498432"]
}

Output

One record per organisation:

{
  "npi": "1881018208",
  "organizationName": "MAYO CLINIC",
  "otherNames": [],
  "isSubpart": false,
  "parentOrganizationName": null,
  "status": "Active",
  "primaryTaxonomyCode": "261QM1300X",
  "primaryTaxonomyDescription": "Clinic/Center, Multi-Specialty",
  "taxonomies": [{"code": "261QM1300X", "description": "Clinic/Center, Multi-Specialty", "primary": true, "state": null, "licenseNumber": null, "taxonomyGroup": null}],
  "practiceAddress": {"line1": "200 1ST ST SW", "line2": null, "city": "ROCHESTER", "state": "MN", "postalCode": "55905-0001", "countryCode": "US", "phone": "507-284-2511", "fax": null},
  "practiceAddressText": "200 1ST ST SW, ROCHESTER, MN 55905-0001",
  "practiceCity": "ROCHESTER",
  "practiceState": "MN",
  "practicePostalCode": "55905-0001",
  "practicePhone": "507-284-2511",
  "practiceFax": null,
  "mailingAddress": {"line1": "200 1ST ST SW", "city": "ROCHESTER", "state": "MN", "postalCode": "55905-0001", "countryCode": "US", "phone": "507-284-2511"},
  "mailingAddressText": "200 1ST ST SW, ROCHESTER, MN 55905-0001",
  "mailingPhone": "507-284-2511",
  "otherPracticeLocations": [],
  "otherIdentifiers": [],
  "enumerationDate": "2014-02-05",
  "lastUpdated": "2021-04-12",
  "certificationDate": "2021-04-12",
  "registryUrl": "https://npiregistry.cms.hhs.gov/provider-view/1881018208",
  "source": "CMS NPPES NPI Registry (npiregistry.cms.hhs.gov), Read API v2.1",
  "licence": "US Government work, public domain (17 U.S.C. 105). ...",
  "retrievedAt": "2026-11-03T20:25:00Z",
  "searchCriteria": {"organization_name": "mayo clinic*", "state": "MN"}
}

Download as JSON, CSV, Excel or via the API. The Organisations table view shows the key columns.

Pricing

Pay per event:

• $0.005 per run (Actor start)
• $0.002 per organisation record returned

So 1,000 organisations cost about $2. Set a maximum cost per run in Apify and the Actor stops cleanly when it is reached.

Data source and licence

• Source: the CMS NPPES NPI Registry Read API v2.1, https://npiregistry.cms.hhs.gov/api/?version=2.1 (documentation). Public, no key needed. CMS refreshes it daily.
• Licence: NPPES data is FOIA-disclosable information that CMS publishes to the public (CMS Data Dissemination). It is a US Government work, which is not subject to copyright under 17 U.S.C. § 105 and is in the US public domain (resources.data.gov: Open Licenses). Every record carries source and licence fields.
• Disclaimer from CMS: issuance of an NPI does not ensure or validate that a provider is licensed or credentialed.
• Fair use: CMS limits NPI Registry queries per hour and asks that bulk downloads use its monthly data file. This Actor sends one request at a time with a pause between requests, backs off on errors, identifies itself with a descriptive User-Agent, and caps requests per run. For a copy of the whole registry, use the CMS NPI Downloadable File.

Limits and tips

• One NPI Registry search returns at most 1,200 matches. With autoSplit on, bigger searches are split by ZIP prefix (state-aware), so you can go past that. Very broad national searches may still stop at the request cap: add a state or taxonomy.
• State/city/ZIP filters match any address by default, so an organisation with a mailing address in your state but a practice elsewhere can appear. Set addressPurpose to PRIMARY to match the main practice location only.
• Taxonomy search matches the description text, so Pharmacy also returns Pharmacy, Community/Retail Pharmacy and similar.
• Phone numbers and addresses are what the organisation reported to NPPES and can be out of date. Check lastUpdated.
• Some organisations are small practices that carry a clinician's name in the business name; that is the organisation's registered legal name as published by CMS.

Use with AI agents (MCP)

Add this Actor as a tool through the Apify MCP server and ask, for example: "Find skilled nursing facilities in Columbus, Ohio with their NPI and phone" or "Check whether NPI 1881018208 is an active organisation and what its primary taxonomy is." The flat, de-duplicated output keeps agent context small.

Not affiliated

This Actor is not affiliated with or endorsed by CMS or HHS.