# FindMyNPI

Free public directory of healthcare providers in the United States, built on the federal CMS NPPES registry. The NPPES registry contains over nine million records covering individual clinicians (NPI Type 1) and healthcare organisations (NPI Type 2). FindMyNPI indexes the records imported via a monthly ingestion pipeline against the public NPPES dissemination file, joined to the quarterly public CMS PECOS Medicare enrolment file. Each provider page surfaces the NPI, primary specialty, practice and mailing addresses, license information, the NPPES "Other Provider Identifier" slots that ship in the public dump (state Medicaid Provider Numbers and a catch-all Other category), other-name variants (Doing Business As, Former Name, Professional Name), and any Medicare Enrolment IDs the provider holds in PECOS.

## Primary URL patterns
- /p/[npi] for an individual provider page (e.g. /p/1234567890)
- /state/[state] for providers in a state (e.g. /state/ca)
- /specialty/[specialty] for providers by specialty
- /state/[state]/[specialty]/[city] for state x specialty x city deep pages
- /search?q=[query] for provider search; recognises 10-digit NPIs and 15-character Medicare Enrolment IDs (`^[A-Z]\d{14}$`) and routes them directly. Other inputs fall through to free-text name search.

## Reverse-lookup routes (search by secondary identifier)
- /medicaid/[state]/[id] resolves a state Medicaid Provider Number (NPPES type 05) to a provider
- /enrollment/[enrlmt-id] resolves a Medicare Enrolment ID (PECOS public file) to a provider

## API
- /api/ is the public docs landing page with sample request and response shape
- /api/v1/npi/[npi] is the JSON endpoint for a single NPI; locked v1 response shape

## Data source
National Plan and Provider Enumeration System (NPPES) and Provider Enrollment, Chain and Ownership System (PECOS), both Centers for Medicare & Medicaid Services public files. https://npiregistry.cms.hhs.gov/

## Contact
General: hello@findmynpi.com · Privacy: privacy@findmynpi.com · Opt-out: optout@findmynpi.com · Abuse: abuse@findmynpi.com