List Providers

Lists providers with optional filtering and pagination.

GET /providers

This endpoint retrieves all of the provider records in your Stedi account. You can filter the results by the provider's name, NPI, or tax ID.

This endpoint returns only the provider record; it doesn't include information about associated transaction enrollments. To retrieve enrollment information, use the List Enrollments endpoint.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Query Parameters

pageSize · Number Range: ≥ 1 and ≤ 500

The maximum number of elements to return in a page. If not specified, the default is 100.

pageToken · String Length: 1 - 1024

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 · Array of Strings

Filter for providers with NPIs matching any value in this list.

providerTaxIds · Array of Strings

Filter for providers with tax IDs matching any value in this list.

Response

application/json

ListProviders 200 response

items · Array of Objects

Details about every provider your organization has created within Stedi.

id · items[].id · String Required

A unique identifier Stedi assigns to this provider internally.

name · items[].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 · items[].npi · String Required

The provider's National Provider Identifier (NPI).

taxId · items[].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 · items[].taxIdType · String

The type of tax ID. Can be either an EIN - Employer Identification Number, or an SSN - Social Security Number.

Possible values

EIN

SSN

nextPageToken · String Length: 1 - 1024

Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.

Request

curl --request GET \
  --url "https://enrollments.us.stedi.com/2024-09-01/providers" \
  --header "Authorization: <api_key>"

Response

{
  "items": [
    {
      "id": "10334e76-f073-4b5d-8984-81d8e5107857",
      "name": "BDQ Dental Inc",
      "npi": "1999999992",
      "taxId": "555123456",
      "taxIdType": "EIN"
    },
    {
      "id": "10234e76-f067-4b5d-8984-81d8e5107123",
      "name": "Example Medical Associates",
      "npi": "1999999984",
      "taxId": "100100111",
      "taxIdType": "EIN"
    }
  ]
}