API reference/Healthcare/Provider Lookup (NPI)

Provider Lookup (NPI)

free

Live data

US clinicians and organizations by NPI, name, specialty and location.

GET/api/v1/healthcare/providers

Data source

NPPES NPI RegistryUS CMS · public-domain · updates Weekly

Query parameters

Parameter	Description	Try value
`npi` string	10-digit NPI
`specialty` string	Taxonomy, e.g. cardiology
`city` string	City
`state` string	State
`lastName` string	Last name
`limit` number	1–50 (default 10)
`apikey` string required	Your API key. Can also be sent as the `X-API-Key` header.	demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.

curl "https://api.sectorapi.com/api/v1/healthcare/providers?specialty=cardiology&city=boston&state=MA&limit=5&apikey=YOUR_API_KEY"

Calls the live source

Example response

{
  "data": {
    "count": 5,
    "providers": [
      {
        "npi": "1730958521",
        "type": "individual",
        "name": "SARAH BEARGIE PharmD",
        "specialty": "Pharmacist, Cardiology",
        "licenseState": "MA",
        "status": "active",
        "address": {
          "line1": "55 FRUIT STREET",
          "city": "BOSTON",
          "state": "MA",
          "zip": "02114",
          "phone": "617-724-1939"
        },
        "enumeratedAt": "2023-12-21",
        "updatedAt": "2023-12-21"
      },
      {
        "npi": "1568145027",
        "type": "individual",
        "name": "AIDAN FISCHER PharmD",
        "specialty": "Pharmacist, Cardiology",
        "licenseState": "MA",
        "status": "active",
        "address": {
          "line1": "800 WASHINGTON ST # 420",
          "city": "BOSTON",
          "state": "MA",
          "zip": "02111",
          "phone": "617-636-1431"
        },
        "enumeratedAt": "2023-08-10",
        "updatedAt": "2023-08-10"
      },
      {
        "npi": "1740114438",
        "type": "individual",
        "name": "JU HEE KIM PharmD",
        "specialty": "Pharmacist, Cardiology",
        "licenseState": "MA",
        "status": "active",
        "address": {
          "line1": "75 FRANCIS ST",
          "city": "BOSTON",
          "state": "MA",
          "zip": "02115",
          "phone": "617-732-7153"
        },
        "enumeratedAt": "2026-06-09",
        "updatedAt": "2026-06-09"
      }
    ]
  }
}