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

This endpoint allows you to submit an enrollment request to Stedi. It’s especially useful when you need to submit bulk enrollments for many providers at once, or if you want to embed enrollment capabilities into your own software platform.

Before you can submit an enrollment request, you must add the provider’s details through either the Providers page or the Create Provider endpoint. Then, you must create one enrollment request for each transaction type. For example, you would create three separate requests to enroll a provider for 837P claims (professional), 270 real-time eligibility checks, and 835 ERAs (claim payments).

Once submitted, Stedi handles the entire enrollment process for you, including submitting the enrollment to the payer, following up as needed, and giving clear guidance for any additional steps that might be required.

After you submit an enrollment request, you can review its details and status on the Enrollments page in Stedi. Alternatively, you can retrieve enrollment details programmatically using the Get Enrollment and List Enrollments endpoints.

What is enrollment?

Some payers require enrollment before they will accept transactions, such as claims and eligibility checks, and before they will send you claim payments (ERAs). Enrollment involves submitting information about the provider that will send or receive transactions, including the provider’s name, tax ID, NPI, billing address, and contact information.

Visit Enrollment for more details.

You can find out if a payer requires enrollment for a particular transaction type in the Stedi Payer Network.

Enrollment status

You can submit enrollment requests with either DRAFT or SUBMITTED status. Once an enrollment is set to SUBMITTED, only Stedi can set or update its status.

Stedi changes the status to PROVISIONING when we begin the enrollment process with the payer.

When an enrollment status is set to LIVE, the provider can start exchanging the enrolled transaction type with the payer.

Contacts

You must add a contact to an enrollment request. The payer may reach out to this contact with updates or questions about the enrollment. If you’re a provider, this should be your information. If you’re a vendor representing a provider, you can submit your contact information instead of the provider’s information.

Authorizations

Authorization
string
headerrequired

A Stedi API Key for authentication.

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.

provider
object
required

Information about the provider enrolling with the payer. You must use the Create Provider endpoint to add the provider to Stedi before you can enroll them with one or more payers.

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.
Available options:
DRAFT,
SUBMITTED,
PROVISIONING,
LIVE
reason
string

Reasons why the enrollment request is still in PROVISIONING status or may take additional time to process. 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.

Response

200 - application/json
id
string
required

The Stedi-assigned identifier for the enrollment request.

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.

transactions
object
required

The type of transactions included in 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.

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>

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.
Available options:
DRAFT,
SUBMITTED,
PROVISIONING,
LIVE
reason
string

Reasons why the enrollment request is still in PROVISIONING status or may take additional time to process. 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.

Was this page helpful?