Update Provider

Updates an existing provider's information. Note that NPI and tax ID cannot be changed after creation.

POST /providers/{providerId}

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

This endpoint allows you to update information for an existing provider. For example, you may want to add an additional contact.

Please note:

• Calling this endpoint completely overwrites the previous request record. You must provide all the information for the provider in the request, not just the properties you want to update.
• Updating a provider record doesn't affect associated enrollments that are in SUBMITTED, PROVISIONING or LIVE status. If you need to update the provider details for an enrollment with these statuses, contact support.

Authorizations

Authorization · string · required · header

A Stedi API Key for authentication.

Path Parameters

providerId · string

The Stedi-assigned identifier for the provider you want to update.

Body

application/json

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>

Either organizationName or firstName and lastName are required.

contacts[]. organizationName · string

The contact's business name.

contacts[]. firstName · string

The contact's first name.

contacts[]. lastName · string

The contact's last name.

contacts[]. email · string · required

The contact's email address.

• 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.

• Minimum length: 8

contacts[]. streetAddress1 · string · required

The contact's street address, including the street number, name, and any suite or apartment number.

• Minimum length: 5

contacts[]. streetAddress2 · string

The contact's street address continued.

contacts[]. city · string · required

The contact's city.

• Minimum length: 2

contacts[]. zipCode · string · required

The contact's five-digit ZIP code.

• Minimum length: 5

contacts[]. state · string · required

The contact's two-letter state abbreviation. For example, PA, or MD.

• Minimum length: 2

Response

application/json

UpdateProvider 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. Note that each provider record must have a unique NPI within Stedi - you cannot create a provider with an NPI that is already in use.

• 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.

• 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>

Either organizationName or firstName and lastName are required.

contacts[]. organizationName · string

The contact's business name.

contacts[]. firstName · string

The contact's first name.

contacts[]. lastName · string

The contact's last name.

contacts[]. email · string · required

The contact's email address.

• 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.

• Minimum length: 8

contacts[]. streetAddress1 · string · required

The contact's street address, including the street number, name, and any suite or apartment number.

• Minimum length: 5

contacts[]. streetAddress2 · string

The contact's street address continued.

contacts[]. city · string · required

The contact's city.

• Minimum length: 2

contacts[]. zipCode · string · required

The contact's five-digit ZIP code.

• Minimum length: 5

contacts[]. state · string · required

The contact's two-letter state abbreviation. For example, PA, or MD.

• Minimum length: 2

cURL

curl --request POST \
  --url "https://enrollments.us.stedi.com/2024-09-01/providers/{providerId}" \
  --header "Authorization: <api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "TEST Updated Dental Inc",
    "contacts": [
      {
        "firstName": "Test",
        "lastName": "Tester",
        "email": "bob@fortdental.center",
        "phone": "555-123-213342",
        "streetAddress1": "123 Some Str",
        "city": "A City",
        "zipCode": "12345",
        "state": "WA"
      }
    ]
  }'

JavaScript

const body = JSON.stringify({
  "name": "TEST Updated Dental Inc",
  "contacts": [
    {
      "firstName": "Test",
      "lastName": "Tester",
      "email": "bob@fortdental.center",
      "phone": "555-123-213342",
      "streetAddress1": "123 Some Str",
      "city": "A City",
      "zipCode": "12345",
      "state": "WA"
    }
  ]
})

fetch("https://enrollments.us.stedi.com/2024-09-01/providers/{providerId}", {
  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/{providerId}"
  body := strings.NewReader(`{
    "name": "TEST Updated Dental Inc",
    "contacts": [
      {
        "firstName": "Test",
        "lastName": "Tester",
        "email": "bob@fortdental.center",
        "phone": "555-123-213342",
        "streetAddress1": "123 Some Str",
        "city": "A City",
        "zipCode": "12345",
        "state": "WA"
      }
    ]
  }`)
  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/{providerId}"
body = {
  "name": "TEST Updated Dental Inc",
  "contacts": [
    {
      "firstName": "Test",
      "lastName": "Tester",
      "email": "bob@fortdental.center",
      "phone": "555-123-213342",
      "streetAddress1": "123 Some Str",
      "city": "A City",
      "zipCode": "12345",
      "state": "WA"
    }
  ]
}
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": "TEST Updated Dental Inc",
  "contacts": [
    {
      "firstName": "Test",
      "lastName": "Tester",
      "email": "bob@fortdental.center",
      "phone": "555-123-213342",
      "streetAddress1": "123 Some Str",
      "city": "A City",
      "zipCode": "12345",
      "state": "WA"
    }
  ]
}""");
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/{providerId}"))
  .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": "TEST Updated Dental Inc",
  "npi": "1999999999",
  "taxId": "111222333",
  "taxIdType": "EIN",
  "updatedAt": "2024-11-19T19:24:33.246Z",
  "contacts": [
    {
      "organizationName": "",
      "firstName": "Test",
      "lastName": "Tester",
      "email": "bob@fortdental.center",
      "phone": "555-123-213342",
      "streetAddress1": "123 Some Str",
      "city": "A City",
      "zipCode": "12345",
      "state": "WA"
    }
  ]
}

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"
}