---
title: "GET /providers"
method: GET
path: "/providers"
---

# GET /providers

`GET /providers`

Lists providers with optional filtering and pagination.

## Query parameters

- `pageSize` number — The maximum number of elements to return in a page. If not specified, the default is 100.
- `pageToken` string — The `nextPageToken` value from a previous response. You can use this to get the next page of results. If not set, Stedi returns the first page of results.
- `filter` string — Filter for providers with properties matching a query string. You can provide all or part of a provider name, NPI, or tax ID. The search is case-insensitive and supports fuzzy matching. For example, providing `?filter=OS` returns providers with names containing `os` (such as `Joseph`).
- `providerNpis` string[] — Filter for providers with NPIs matching any value in this list.
- `providerTaxIds` string[] — Filter for providers with tax IDs matching any value in this list.

## Response `200`

ListProviders 200 response

- ListProvidersResponseContent — Output containing a paginated list of providers.
  - `items` ProviderSummary[] — Details about every provider your organization has created within Stedi.
    - `id` string, required — A unique identifier Stedi assigns to this provider internally.
    - `name` string, required — The provider's business name. This is typically the provider's practice name, such as `Dental Associates, LLC`, but it can also be the provider's first and last name.
    - `npi` string, required — The provider's [National Provider Identifier (NPI)](https://npiregistry.cms.hhs.gov/search).
    - `taxId` string — The provider's tax ID, as specified by `taxIdType`. This identifier is formatted without any separators, such as dashes or spaces. For example 111-22-3333 is represented as `111223333`.
    - `taxIdType` 'EIN' | 'SSN' — The type of tax identification number. Organizations (Type 2 NPIs) must use `EIN`, while individual providers (Type 1 NPIs) can use either `EIN` or `SSN`.
  - `nextPageToken` string — Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.

## Other responses

- `400` — ValidationException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `429` — QuotaExceededException 429 response
- `500` — InternalFailureException 500 response
- `503` — ServiceUnavailableException 503 response
- `504` — GatewayTimeoutException 504 response

---

[API](https://skmtc.net/stedi/apis/stedi-enrollment.md) · [All operations](https://skmtc.net/stedi/apis/stedi-enrollment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-enrollment/versions/0a692cc4f303/schema)