Skip to content

NPI lookup API for provider name, specialty and license

Send a 10-digit NPI and get the provider's NPPES record: name, individual or organization type, taxonomy, license, practice address and status. 2 credits per lookup.

2 creditsEnrichCSV bulkMCP
POST/v1/npi-lookup
{
  "success": true,
  "data": {
    "npi": "1234567893",
    "entity_type": "individual",
    "status": "active",
    "enumeration_date": "2009-07-14",
    "last_updated": "2025-03-02",
    "name": {
      "first": "Jordan",
      "last": "Avery",
      "credential": "MD"
    },
    "taxonomies": [
      {
        "code": "207R00000X",
        "description": "Internal Medicine",
        "primary": true,
        "license_number": "EX12345",
        "license_state": "TX"
      }
    ],
    "practice_address": {
      "line1": "1200 Example Ave",
      "line2": "Suite 300",
      "city": "Austin",
      "state": "TX",
      "zip": "78701",
      "phone": "+15125550118"
    },
    "mailing_address": {
      "line1": "500 Example Plaza",
      "line2": "Floor 2",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    }
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

nameProvider nameThe individual's name and credential, or the organization's legal name.
entity_typeEntity typeindividual for a clinician, organization for a group practice, hospital or other business.
statusStatusWhether the NPI is active or has been deactivated.
taxonomies[].descriptionSpecialtyThe plain-language specialty for each taxonomy code, with the primary one marked.
taxonomies[].license_numberLicenseThe license number and issuing state the provider reported with that taxonomy.
practice_addressPractice addressWhere the provider sees patients, with the practice phone number.
mailing_addressMailing addressThe correspondence address on the record, which can differ from the practice location.
enumeration_dateEnumeration dateThe date CMS first issued the NPI.
[02/Capabilities]

What NPI Lookup does

01

Individuals and organizations

Type 1 NPIs belong to individual clinicians. Type 2 NPIs belong to organizations such as group practices, hospitals and pharmacies. The response says which one you have and returns the matching name fields.

02

Taxonomy and specialty

Each record lists the provider's taxonomy codes with a readable specialty and marks the primary one. Use it to route a referral, segment a list or check that a clinician practices the specialty on the form.

03

License number and state

Where the provider reported a license with a taxonomy, you get the number and the issuing state. That is the starting point for a check with the state licensing board.

04

Practice and mailing addresses

Both addresses on the NPPES record come back in structured form. Billing teams use the practice location, and outreach teams often need the mailing address.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/npi-lookup2 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/npi-lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"npi":"1234567893"}'
Endpoint
POST /v1/npi-lookup
Base URL
https://api.1lookup.dev
Request
npi
Price
2 credits
Coverage
US health care providers
Source
CMS NPPES NPI Registry
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Validate NPIs before a claim goes out

Look up the rendering and referring NPIs on a claim. A mistyped or deactivated number is caught in your system, not in a payer rejection.

Prefill provider onboarding

Ask a new provider for an NPI and fill in name, specialty and address from the registry, so the applicant confirms details and your team skips the data entry.

Clean a provider directory or CRM

Run your stored NPIs through a bulk job and update records where the specialty, address or status has changed.

Segment a health care market

Sales teams append taxonomy and entity type to an account list, then build territories by specialty.

NPPES data is self-reported by providers. It confirms that an NPI exists and what the provider reported, not that a license is current or that the provider is in good standing.

[06/Cost]

2 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$9.67
Growth $99/mo$3.96$7.92
Pro $299/mo$3.32$6.64
Scale $799/mo$2.66$5.33
[07/FAQ]

NPI Lookup questions

What is an NPI?

The National Provider Identifier is a 10-digit number that CMS issues to health care providers in the US. Providers use it on claims and other standard transactions, and it stays with them when they change jobs or locations.

Does an active NPI mean the provider is licensed?

No. NPPES is self-reported, and CMS does not verify licenses or credentials when it issues an NPI. Use the license number in the response to confirm with the state board, and run OIG Exclusion Check to see whether the provider is barred from federal programs.

How much does an NPI lookup cost?

2 credits per NPI. The smallest plan, $29 a month, includes 6,000 credits, which is 3,000 lookups.

Who maintains the registry, and how often do records change?

The data comes from the NPPES NPI Registry run by CMS. Records change when providers update them, and our data follows the NPPES publication schedule. The response includes the date the record was last updated.

Can I look up NPIs in bulk?

Yes. Upload a CSV of NPIs in the dashboard or send the list to the bulk API. The output keeps your original columns, adds the registry fields and reports any rows that could not be processed.

[ Validate ][ Enrich ]
[Get started]

Run NPI Lookup on your own data

Starter is $29 a month for 6,000 credits, enough for 3,000 lookups a month.

[ Screen ][ Scrape ]