Update Enrollment

POST

enrollments

{enrollmentId}

curl --request POST \
  --url https://enrollments.us.stedi.com/2024-09-01/enrollments/{enrollmentId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "transactions": {
    "claimPayment": {
      "enroll": true
    }
  },
  "primaryContact": {
    "firstName": "Updated First Name",
    "lastName": "Updated Last Name",
    "email": "test@example.com",
    "phone": "333-123-34354",
    "streetAddress1": "123 Some Str.",
    "city": "A City",
    "state": "MD",
    "zipCode": "20814"
  },
  "userEmail": "test@example.com",
  "payer": {
    "idOrAlias": "87726"
  },
  "provider": {
    "id": "db6665c5-7b97-4af9-8c68-a00a336c2998"
  }
}'

{
  "id": "db6675c5-7bg7-4af9-8c68-a54a336d2911",
  "primaryContact": {
    "firstName": "Updated First Name",
    "lastName": "Updated Last Name",
    "email": "test@example.com",
    "phone": "333-123-34354",
    "streetAddress1": "123 Some Str.",
    "city": "A City",
    "state": "MD",
    "zipCode": "20814"
  },
  "userEmail": "test@example.com",
  "createdAt": "2024-11-07T05:31:56Z",
  "updatedAt": "2024-11-18T07:25:42Z",
  "transactions": {
    "claimPayment": {
      "enroll": true
    }
  },
  "status": "DRAFT",
  "provider": {
    "name": "Test Medical Provider",
    "id": "db6665c5-7b97-4af9-8c68-a00a336c2998"
  },
  "payer": {
    "name": "UnitedHealthcare",
    "stediPayerId": "87726"
  },
  "source": "API"
}

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

This endpoint allows you to update enrollments that are still in DRAFT status. If you need to make changes to an enrollment that is already in SUBMITTED, PROVISIONING, LIVE, REJECTED, or CANCELED status, contact support.

Calling this endpoint completely overwrites the previous request record. You must provide all the information for the enrollment in the request, not just the properties you want to update.

Authorizations

Authorization

string

header

required

A Stedi API Key for authentication.

Path Parameters

enrollmentId

string

required

The Stedi-assigned identifier for the enrollment.

Body

application/json

transactions

object

required

The type of transactions included in the enrollment.

primaryContact

object

required

The contact information for the provider or the entity completing the enrollment on the provider's behalf. Either organizationName or firstName and lastName are required. Payers may use this information to contact the provider or their representative directly regarding the status of the enrollment.

userEmail

string

required

The email address of the user submitting the enrollment. This email will be used by Stedi staff to provide updates and communicate about the enrollment's progress. It is distinct from the primary contact's email, which is used by the payer to contact the provider directly.

Minimum length: 5

provider

object

required

Information about the provider enrolling with the payer.

payer

object

required

Information about the payer the provider is enrolling with.

status

enum<string>

The status of the enrollment. You can submit enrollments with either DRAFT or SUBMITTED status. However, once an enrollment is set to SUBMITTED status, only Stedi can set or update this property.

DRAFT - You are still editing the record and it has not been submitted to Stedi.
SUBMITTED - You have successfully submitted the request and it is in Stedi's queue for review.
PROVISIONING - Stedi has begun the process of completing the enrollment with the payer.
LIVE - The enrollment process is complete, and the specified provider can begin exchanging the listed transaction types with the payer.
REJECTED - The payer rejected the enrollment. Common reasons for rejection include incorrect details in the request and that the provider is not credentialed with the payer. Customer support will contact you with reasons for rejection and next steps.
CANCELED - The enrollment has been terminated per customer or provider request.

Available options:

DRAFT,

SUBMITTED,

PROVISIONING,

LIVE,

REJECTED,

CANCELED

source

enum<string>

The source of this enrollment.

Available options:

API,

UI,

IMPORT

reason

string

Reasons why the enrollment request is still in PROVISIONING status, may take additional time to process, or was rejected by the payer. Only Stedi can set or update this property.

May contain extra required steps for processing that are specific to the payer. For example, perhaps the provider needs to log into an online portal and enter additional information before the enrollment can continue. Contact Stedi customer support with questions.

internal_note

string

Internal notes about the enrollment. Only Stedi can read, set, or update this property.

providerTransactionAccessNumber

string

Required for payers that require it. The Provider Transaction Access Number (PTAN) is a Medicare-issued number given to providers upon enrollment with Medicare. This number is usually six digits and is assigned based on the type of service and the location of the provider. Upon enrollment, Medicare Administrating Contracting (MAC) providers should receive their assigned PTAN number in their approval letter.

Required string length: 5 - 10

Response

200

application/json

UpdateEnrollment 200 response

string

required

The Stedi-assigned identifier for the enrollment request.

primaryContact

object

required

transactions

object

required

The type of transactions included in the enrollment.

userEmail

string

required

Minimum length: 5

provider

object

required

Information about the provider enrolling with the payer.

payer

object

required

Information about the payer the provider is enrolling with.

createdAt

string

The date and time when the enrollment was created within Stedi.

updatedAt

string

The date and time when the enrollment was updated.

submittedAt

string

The date and time when the enrollment was submitted. If the enrollment is in draft status, submittedAt is not present. When the enrollment transitions from draft to submitted, submittedAt will be updated to the submission time. If the enrollment was created and submitted immediately, submittedAt will be equal or close to createdAt.

status

enum<string>

DRAFT - You are still editing the record and it has not been submitted to Stedi.
SUBMITTED - You have successfully submitted the request and it is in Stedi's queue for review.
PROVISIONING - Stedi has begun the process of completing the enrollment with the payer.
LIVE - The enrollment process is complete, and the specified provider can begin exchanging the listed transaction types with the payer.
REJECTED - The payer rejected the enrollment. Common reasons for rejection include incorrect details in the request and that the provider is not credentialed with the payer. Customer support will contact you with reasons for rejection and next steps.
CANCELED - The enrollment has been terminated per customer or provider request.

Available options:

DRAFT,

SUBMITTED,

PROVISIONING,

LIVE,

REJECTED,

CANCELED

source

enum<string>

The source of this enrollment.

Available options:

API,

UI,

IMPORT

reason

string

Reasons why the enrollment request is still in PROVISIONING status, may take additional time to process, or was rejected by the payer. Only Stedi can set or update this property.

internal_note

string

Internal notes about the enrollment. Only Stedi can read, set, or update this property.

providerTransactionAccessNumber

string

Required string length: 5 - 10

Was this page helpful?

Update Provider Delete Provider

curl --request POST \
  --url https://enrollments.us.stedi.com/2024-09-01/enrollments/{enrollmentId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "transactions": {
    "claimPayment": {
      "enroll": true
    }
  },
  "primaryContact": {
    "firstName": "Updated First Name",
    "lastName": "Updated Last Name",
    "email": "test@example.com",
    "phone": "333-123-34354",
    "streetAddress1": "123 Some Str.",
    "city": "A City",
    "state": "MD",
    "zipCode": "20814"
  },
  "userEmail": "test@example.com",
  "payer": {
    "idOrAlias": "87726"
  },
  "provider": {
    "id": "db6665c5-7b97-4af9-8c68-a00a336c2998"
  }
}'

{
  "id": "db6675c5-7bg7-4af9-8c68-a54a336d2911",
  "primaryContact": {
    "firstName": "Updated First Name",
    "lastName": "Updated Last Name",
    "email": "test@example.com",
    "phone": "333-123-34354",
    "streetAddress1": "123 Some Str.",
    "city": "A City",
    "state": "MD",
    "zipCode": "20814"
  },
  "userEmail": "test@example.com",
  "createdAt": "2024-11-07T05:31:56Z",
  "updatedAt": "2024-11-18T07:25:42Z",
  "transactions": {
    "claimPayment": {
      "enroll": true
    }
  },
  "status": "DRAFT",
  "provider": {
    "name": "Test Medical Provider",
    "id": "db6665c5-7b97-4af9-8c68-a00a336c2998"
  },
  "payer": {
    "name": "UnitedHealthcare",
    "stediPayerId": "87726"
  },
  "source": "API"
}

Payers & enrollment

Eligibility & benefits

Claims processing

EDI platform

Update Enrollment

Authorizations

Path Parameters

Body

Response