Create Provider

Creates a new provider record. Providers must be created before they can be enrolled with payers.

POST /providers

This is a beta endpoint. We may make backwards incompatible changes.

This endpoint allows you to create a provider record with the details required for transaction enrollment.

1. Call this endpoint with the provider's details.
2. The endpoint returns the created provider record, including the provider id, which you'll need when creating enrollment requests.

You can now add the provider to one or more transaction enrollment requests.

All providers you create through this endpoint are available on the Providers page for you to review and manage.

Contacts

You can add one or more contacts to a provider record. This is where the payer will send communications about the enrollment, if needed.

• The provider's name and address should match exactly what the payer has on file. Some payers reject enrollment requests with addresses that don't match their records.
• However, you may want to set the phone number or email to your own contact details. Do this when you want the payer to contact you about the enrollment instead of the provider directly.

Authorizations

Authorization · string · required · header

A Stedi API Key for authentication.

Body

application/json

npi · string · required

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

Each provider record must have a unique npi and taxId combination. For example, you can create two provider records with the same npi as long as they have different values for taxId.

• Pattern: ^[0-9]{10}$

taxIdType · string · required

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 · required

The provider's tax ID, as specified by taxIdType. This identifier has to be provided without any separators, such as dashes or spaces. For example 111-22-3333 is invalid but 111223333 is valid.

Each provider record must have a unique npi and taxId combination. For example, you can create two provider records with the same taxId as long as they have different values for npi.

• Pattern: ^\d{9}$

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.

• Minimum length: 5

contacts · array<object>

The contact information for the provider. This is where the payer will send communications about the enrollment, if needed.

• Either organizationName or firstName and lastName are required.
• The name and address should match exactly what the payer has on file for the provider. Some payers reject enrollment requests with addresses that don't match their records.
• If you're submitting enrollment requests on a provider's behalf, you may want to set the phone number and email to your own contact details. Do this when you want the payer to contact you about the enrollment status instead of the provider directly.

contacts[]. organizationName · string

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

contacts[]. firstName · string

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

contacts[]. lastName · string

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

contacts[]. email · string · required

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.

• Pattern: ^\S+@\S+\.\S+$
• Minimum length: 5

contacts[]. phone · string · required

The contact's phone number, starting with the area code and formatted with dashes as separators. For example, 555-555-5555. 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.

• Minimum length: 8

contacts[]. streetAddress1 · string · required

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.

• Minimum length: 5

contacts[]. streetAddress2 · string

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

contacts[]. city · string · required

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

• Minimum length: 2

contacts[]. zipCode · string · required

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

• Minimum length: 5

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.

• Minimum length: 2

Response

application/json

CreateProvider 200 response

id · string · required

A unique identifier Stedi assigns to this provider.

createdAt · string

The date and time Stedi created the provider record.

• Format: date-time

updatedAt · string

The date and time Stedi last updated the provider record.

• Format: date-time

npi · string · required

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

Each provider record must have a unique npi and taxId combination. For example, you can create two provider records with the same npi as long as they have different values for taxId.

• Pattern: ^[0-9]{10}$

taxIdType · string · required

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 · required

The provider's tax ID, as specified by taxIdType. This identifier has to be provided without any separators, such as dashes or spaces. For example 111-22-3333 is invalid but 111223333 is valid.

Each provider record must have a unique npi and taxId combination. For example, you can create two provider records with the same taxId as long as they have different values for npi.

• Pattern: ^\d{9}$

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.

• Minimum length: 5

contacts · array<object>

The contact information for the provider. This is where the payer will send communications about the enrollment, if needed.

• Either organizationName or firstName and lastName are required.
• The name and address should match exactly what the payer has on file for the provider. Some payers reject enrollment requests with addresses that don't match their records.
• If you're submitting enrollment requests on a provider's behalf, you may want to set the phone number and email to your own contact details. Do this when you want the payer to contact you about the enrollment status instead of the provider directly.

contacts[]. organizationName · string

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

contacts[]. firstName · string

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

contacts[]. lastName · string

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

contacts[]. email · string · required

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.

• Pattern: ^\S+@\S+\.\S+$
• Minimum length: 5

contacts[]. phone · string · required

The contact's phone number, starting with the area code and formatted with dashes as separators. For example, 555-555-5555. 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.

• Minimum length: 8

contacts[]. streetAddress1 · string · required

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.

• Minimum length: 5

contacts[]. streetAddress2 · string

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

contacts[]. city · string · required

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

• Minimum length: 2

contacts[]. zipCode · string · required

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

• Minimum length: 5

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.

• Minimum length: 2

cURL

curl --request POST \
  --url "https://enrollments.us.stedi.com/2024-09-01/providers" \
  --header "Authorization: <api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "BDQ Dental Inc",
    "npi": "1999999992",
    "taxIdType": "EIN",
    "taxId": "555123456",
    "contacts": [
      {
        "firstName": "Bob",
        "lastName": "Dentist",
        "email": "bob@fortdental.center",
        "phone": "555-123-2135",
        "streetAddress1": "123 Some Str",
        "city": "Chevy Chase",
        "zipCode": "20814",
        "state": "MD"
      },
      {
        "firstName": "Tom",
        "lastName": "Dentist",
        "email": "tom@fortdental.center",
        "phone": "555-123-2133",
        "streetAddress1": "123 Some Str",
        "city": "Chevy Chase",
        "zipCode": "20814",
        "state": "MD"
      }
    ]
  }'

JavaScript

const body = JSON.stringify({
  "name": "BDQ Dental Inc",
  "npi": "1999999992",
  "taxIdType": "EIN",
  "taxId": "555123456",
  "contacts": [
    {
      "firstName": "Bob",
      "lastName": "Dentist",
      "email": "bob@fortdental.center",
      "phone": "555-123-2135",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    },
    {
      "firstName": "Tom",
      "lastName": "Dentist",
      "email": "tom@fortdental.center",
      "phone": "555-123-2133",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    }
  ]
})

fetch("https://enrollments.us.stedi.com/2024-09-01/providers", {
  headers: {
    "Authorization": "<api_key>"
  },
  body
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://enrollments.us.stedi.com/2024-09-01/providers"
  body := strings.NewReader(`{
    "name": "BDQ Dental Inc",
    "npi": "1999999992",
    "taxIdType": "EIN",
    "taxId": "555123456",
    "contacts": [
      {
        "firstName": "Bob",
        "lastName": "Dentist",
        "email": "bob@fortdental.center",
        "phone": "555-123-2135",
        "streetAddress1": "123 Some Str",
        "city": "Chevy Chase",
        "zipCode": "20814",
        "state": "MD"
      },
      {
        "firstName": "Tom",
        "lastName": "Dentist",
        "email": "tom@fortdental.center",
        "phone": "555-123-2133",
        "streetAddress1": "123 Some Str",
        "city": "Chevy Chase",
        "zipCode": "20814",
        "state": "MD"
      }
    ]
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Authorization", "<api_key>")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

import requests

url = "https://enrollments.us.stedi.com/2024-09-01/providers"
body = {
  "name": "BDQ Dental Inc",
  "npi": "1999999992",
  "taxIdType": "EIN",
  "taxId": "555123456",
  "contacts": [
    {
      "firstName": "Bob",
      "lastName": "Dentist",
      "email": "bob@fortdental.center",
      "phone": "555-123-2135",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    },
    {
      "firstName": "Tom",
      "lastName": "Dentist",
      "email": "tom@fortdental.center",
      "phone": "555-123-2133",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    }
  ]
}
response = requests.request("POST", url, json = body, headers = {
  "Authorization": "<api_key>",
  "Content-Type": "application/json"
})

print(response.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;

var body = BodyPublishers.ofString("""{
  "name": "BDQ Dental Inc",
  "npi": "1999999992",
  "taxIdType": "EIN",
  "taxId": "555123456",
  "contacts": [
    {
      "firstName": "Bob",
      "lastName": "Dentist",
      "email": "bob@fortdental.center",
      "phone": "555-123-2135",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    },
    {
      "firstName": "Tom",
      "lastName": "Dentist",
      "email": "tom@fortdental.center",
      "phone": "555-123-2133",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    }
  ]
}""");
HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://enrollments.us.stedi.com/2024-09-01/providers"))
  .header("Content-Type", "application/json")
  .header("Authorization", "<api_key>")
  .POST(body)
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

200

{
  "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": "555-123-2135",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    },
    {
      "organizationName": "",
      "firstName": "Tom",
      "lastName": "Dentist",
      "email": "tom@fortdental.center",
      "phone": "555-123-2133",
      "streetAddress1": "123 Some Str",
      "city": "Chevy Chase",
      "zipCode": "20814",
      "state": "MD"
    }
  ]
}

400

{
  "message": "string",
  "fieldList": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

401

{
  "message": "string",
  "code": "string"
}

403

{
  "message": "string",
  "code": "string"
}

404

{
  "message": "string",
  "code": "string"
}

500

{
  "message": "string",
  "code": "string"
}