---
title: "Search the provider registry"
method: GET
path: "/api/v1/nppes/providers"
tags: ["nppes"]
---

# Search the provider registry

`GET /api/v1/nppes/providers`

## Request

- Base URL: `https://api.tppflow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tppflow.com/api/v1/nppes/providers`
- Auth: none declared

## Query parameters

- `name` string, nullable
- `state` string, nullable: 2-letter state
- `taxonomy` string, nullable
- `limit` integer

## Response `200`

Successful Response

- NppesProvider[]
  - `npi` string, required: 10-digit National Provider Identifier
  - `entity_type` string, nullable: individual | organization
  - `name` string, nullable
  - `primary_taxonomy` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `enumeration_date` string, nullable: YYYY-MM-DD
  - `status` string, nullable

## Other responses

- `402`: Dataset not yet provisioned (private beta)
- `422`: Validation Error

---

[API](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth.md) · [All operations](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth/llms.txt) · [OpenAPI document](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth/revisions/9cc882993c5a?raw)