# HHS API: Get provider by NPI

> 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.

Unofficial. Not affiliated with or endorsed by HHS.

- Page: https://fous.com/methods/npiregistry.cms.hhs.gov/get-provider
- Method: `npiregistry.cms.hhs.gov/get_provider`, version 1
- Website: npiregistry.cms.hhs.gov
- Returns: name, provider type, specialties, practice and mailing addresses, phone, fax, license state, status, registry dates, 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 |
|---|---|---|---|---|
| `npi_number` | string | yes | `"1003000126"` | The 10-digit NPI number shown on a medical bill, prescription or claim, for example 1003000126. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "npi_number": "1003000126"
}
```

Its output:

```json
{
  "fax": null,
  "name": "ARDALAN ENKESHAFI, M.D.",
  "phone": "443-602-6207",
  "status": "active",
  "specialties": [
    {
      "name": "Internal Medicine",
      "is_primary": false,
      "license_state": "MD"
    },
    {
      "name": "Internal Medicine",
      "is_primary": false,
      "license_state": "MD"
    },
    {
      "name": "Internal Medicine",
      "is_primary": false,
      "license_state": "VA"
    }
  ],
  "license_state": "DC",
  "provider_type": "individual",
  "registry_link": "https://npiregistry.cms.hhs.gov/provider-view/1003000126",
  "mailing_address": "6410 ROCKLEDGE DR STE 304, BETHESDA, MD 20817-1841",
  "practice_address": "6410 ROCKLEDGE DR STE 304, BETHESDA, MD 20817-1841",
  "date_last_updated": "2025-05-28",
  "date_first_registered": "2007-08-31"
}
```

## 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/get_provider","input":{"npi_number":"1003000126"}}'
```

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

- Look up the provider with NPI 1003000126 and show me their specialty and practice address
- I got a claim with NPI 1487654321 on it, can you pull up who that doctor is and their phone number?
- Check the NPI registry for 1679576722 and tell me if the provider's status is active
- What license state and registry dates are on file for NPI 1972648135 on hhs.gov?
- Find the practice and mailing addresses for the clinic tied to NPI 1215987403 from my prescription label

## Input schema

```json
{
  "type": "object",
  "required": [
    "npi_number"
  ],
  "properties": {
    "npi_number": {
      "type": "string",
      "maxLength": 10,
      "minLength": 10,
      "description": "The 10-digit NPI number shown on a medical bill, prescription or claim, for example 1003000126."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "provider_type",
    "specialties",
    "practice_address",
    "mailing_address",
    "phone",
    "fax",
    "license_state",
    "status",
    "date_first_registered",
    "date_last_updated",
    "registry_link"
  ],
  "properties": {
    "fax": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": "string",
      "description": "Provider name with credentials when listed."
    },
    "phone": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "enum": [
        "active",
        "deactivated"
      ],
      "type": "string"
    },
    "specialties": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "is_primary",
          "license_state"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "is_primary": {
            "type": "boolean"
          },
          "license_state": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "license_state": {
      "type": [
        "string",
        "null"
      ],
      "description": "State of the primary specialty license, when listed."
    },
    "provider_type": {
      "enum": [
        "individual",
        "organisation"
      ],
      "type": "string"
    },
    "registry_link": {
      "type": "string",
      "format": "uri"
    },
    "mailing_address": {
      "type": [
        "string",
        "null"
      ]
    },
    "practice_address": {
      "type": [
        "string",
        "null"
      ]
    },
    "date_last_updated": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "date_first_registered": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    }
  },
  "additionalProperties": false
}
```

## See more

- [HHS API: Search healthcare providers](https://fous.com/methods/npiregistry.cms.hhs.gov/search-providers.md): 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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [NIH API: Get PubMed article](https://fous.com/methods/pubmed.ncbi.nlm.nih.gov/get-article.md): Gets the full PubMed abstract and publication details for one article by title, PubMed link, or PubMed number (PMID). A title is searched in PubMed titles first and must closely match a found article. Some articles have no abstract or free full text.
- [NIH API: Search diagnosis codes](https://fous.com/methods/clinicaltables.nlm.nih.gov/search-diagnosis-codes.md): Finds ICD-10-CM diagnosis codes and official names from a plain-language condition description, retrying with simplified wording when the first search finds nothing.
- [All HHS methods](https://fous.com/methods/hhs.gov.md)
