# Npidb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for healthcare providers and organizations by name to instantly retrieve their credentials, contact information, and specialty taxonomy codes from the National Provider Identifier database. Look up detailed provider profiles to verify qualifications and find the right medical professionals for your needs.

**Category:** Healthcare | **Website:** [npidb.org/](https://npidb.org/) | **Docs:** [parse.bot/marketplace/be8922aa-26b5-4a31-8d43-475a4f140f0d/npidb-org-api](https://parse.bot/marketplace/be8922aa-26b5-4a31-8d43-475a4f140f0d/npidb-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-npidb-org-api-be8922aa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_provider_detail

Get full profile details for a provider by their 10-digit NPI number. Returns name, address, phone, fax, taxonomy specialties, and additional details such as enumeration date, credentials, and entity type. The NPI must exist in the registry.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `npi` | string | Yes | 10-digit National Provider Identifier number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-npidb-org-api-be8922aa/get_provider_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"npi":"<string>"}'
```

### list_taxonomy_codes

Browse all healthcare taxonomy categories available in the NPI registry. Returns the full list of top-level taxonomy category names with their URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-npidb-org-api-be8922aa/list_taxonomy_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_organizations_by_name

Search for healthcare organizations or medical groups by name. Returns paginated results with NPI numbers, locations, and taxonomy specialties.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `org_name` | string | Yes | Organization or medical group name to search for. |
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | Two-letter US state code to filter results (e.g., CA, FL, MN). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-npidb-org-api-be8922aa/search_organizations_by_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"org_name":"<string>","page":"<integer>","state":"<string>"}'
```

### search_providers_by_name

Search for healthcare providers by first name, last name, and state. Returns paginated results with NPI numbers, credentials, locations, and taxonomy specialties. At least one of first_name, last_name, or state should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | Provider first name to search for. |
| `last_name` | string | No | Provider last name to search for. |
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | Two-letter US state code (e.g., NY, CA, TX). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-npidb-org-api-be8922aa/search_providers_by_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"<string>","last_name":"<string>","page":"<integer>","state":"<string>"}'
```