Retrieve Provider

Retrieves a provider record by its ID. This operation returns the complete provider details including contact information.

GET /providers/{providerId}

This endpoint allows you to retrieve details for the specified provider.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Path Parameters

providerId · String

The unique ID Stedi assigned to the provider when it was created in the system.

Response

application/json

GetProvider 200 response

id · String Required

A unique identifier Stedi assigns to this provider.

createdAt · String Format: date-time

The date and time Stedi created the provider record.

updatedAt · String Format: date-time

The date and time Stedi last updated the provider record.

npi · String Required Regex pattern: ^[0-9]{10}$

The provider's National Provider Identifier (NPI). This is a 10-digit number that is unique to the provider.

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

taxId · String Regex pattern: ^\d{9}$

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.

name · String Required Min length: 5

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.

contacts · Array of Objects

The contact information for the provider. These contacts appear as prepopulated options for contact information when creating enrollment requests for this provider in the Stedi portal. They aren't automatically added to enrollment requests.

These contacts should specify where payers should send communications about the enrollment, if needed.

organizationName · contacts[].organizationName · String

The contact's business name. This should match exactly what the payer has on file for the provider.

firstName · contacts[].firstName · String

The contact's first name. This should match exactly what the payer has on file for the provider.

lastName · contacts[].lastName · String

The contact's last name. This should match exactly what the payer has on file for the provider.

email · contacts[].email · String Required Regex pattern: ^\S+@\S+\.\S+$ Min length: 5

The contact's email address. Set this to where you want the payer to send communications regarding the enrollment. This can be different from the provider's email if needed.

phone · contacts[].phone · String Required Regex pattern: ^(?:[\s().-]*\d){10}[\s().-]*$

The contact's phone number. Set this to where you want the payer to direct communications regarding the enrollment. This can be different from the provider's phone number if needed.

streetAddress1 · contacts[].streetAddress1 · String Required Min length: 5

The contact's street address, including the street number, name, and any suite or apartment number. This should match exactly what the payer has on file for the provider.

streetAddress2 · contacts[].streetAddress2 · String

The contact's street address continued. This should match exactly what the payer has on file for the provider.

city · contacts[].city · String Required Min length: 2

The contact's city. This should match exactly what the payer has on file for the provider.

zipCode · contacts[].zipCode · String Required Min length: 5

The contact's five-digit ZIP code. This should match exactly what the payer has on file for the provider.

state · contacts[].state · String Required

The contact's two-letter state abbreviation. For example, PA, or MD. This should match exactly what the payer has on file for the provider.

Possible values

AA

AE

AK

AL

AP

Request

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

Response

{
  "createdAt": "2024-11-18T17:39:52.406Z",
  "id": "10334e76-f073-4b5d-8984-81d8e5107857",
  "name": "BDQ Dental Inc",
  "npi": "1999999992",
  "taxId": "555123456",
  "taxIdType": "EIN",
  "updatedAt": "2024-11-18T17:39:52.406Z",
  "contacts": [
    {
      "organizationName": "",
      "firstName": "Bob",
      "lastName": "Dentist",
      "email": "bob@fortdental.center",
      "phone": "5551234567",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    },
    {
      "organizationName": "",
      "firstName": "Tom",
      "lastName": "Dentist",
      "email": "tom@fortdental.center",
      "phone": "5551234568",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    }
  ]
}