Create Enrollment

Creates a new enrollment request for a provider with a payer. This operation registers a provider to exchange specific transaction types with a payer through Stedi.

POST/enrollments

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

This endpoint allows you to submit a transaction enrollment request for a specific provider. 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).

Before you can submit an enrollment request, you must add the provider's details through either the Providers page or the Create Provider endpoint.

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.

Authorizationstringrequiredheader

A Stedi API Key for authentication.

Body

application/json
transactionseligibilityCheck | claimStatus | professionalClaimSubmission | institutionalClaimSubmission | dentalClaimSubmission | claimPayment | solicitedClaimAttachment | unsolicitedClaimAttachmentrequired

The type of transactions included in the enrollment.

Whether 270 Eligibility Checks are included in the enrollment.

Show attributes

Whether 276 Claim Status Requests are included in the enrollment.

Show attributes

Whether 837P Professional Claims are included in the enrollment.

Show attributes

Whether 837I Institutional Claims are included in the enrollment.

Show attributes

Whether 837D Dental Claims are included in the enrollment.

Show attributes

Whether 835 Electronic Remittance Advice (ERAs) are included in the enrollment.

Show attributes

Whether Solicited Claim Attachments are included in the enrollment.

Show attributes

Whether Unsolicited Claim Attachments are included in the enrollment.

Show attributes
primaryContactobjectrequired

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.

Show attributes

The contact's business name.

The contact's first name.

The contact's last name.

primaryContact.emailstringrequired

The contact's email address.

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

The contact's phone number, starting with the area code and formatted with dashes as separators. For example, 555-555-5555.

  • Minimum length: 8

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

  • Minimum length: 5

The contact's street address continued.

primaryContact.citystringrequired

The contact's city.

  • Minimum length: 2

The contact's five-digit ZIP code.

  • Minimum length: 5
primaryContact.statestringrequired

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

  • Minimum length: 2
userEmailstringrequired

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.

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

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.
Possible values
DRAFT
SUBMITTED
PROVISIONING
LIVE
REJECTED
sourcestring

The source of this enrollment.

Possible values
API
UI
IMPORT
reasonstring

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 notes about the enrollment. Only Stedi can read, set, or update this property.

This property is required for payers that require a Provider Transaction Access Number (PTAN).

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

  • Pattern: ^[a-zA-Z0-9]+$
  • Required string length: 5 - 10
providerobjectrequired

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.

Show attributes
provider.idstringrequired

The Stedi-assigned identifier for the provider.

payerobjectrequired

Information about the payer the provider is enrolling with.

Show attributes
payer.idstring

Deprecated. Use idOrAlias instead. This field will be removed in the future.

The Payer ID. This can be the primary Payer ID, the Stedi Payer ID, or any listed aliases for the payer. Visit the Payer Network for a complete list.

Response

application/json

CreateEnrollment 200 response

idstringrequired

The Stedi-assigned identifier for the enrollment request.

primaryContactobjectrequired

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.

Show attributes

The contact's business name.

The contact's first name.

The contact's last name.

primaryContact.emailstringrequired

The contact's email address.

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

The contact's phone number, starting with the area code and formatted with dashes as separators. For example, 555-555-5555.

  • Minimum length: 8

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

  • Minimum length: 5

The contact's street address continued.

primaryContact.citystringrequired

The contact's city.

  • Minimum length: 2

The contact's five-digit ZIP code.

  • Minimum length: 5
primaryContact.statestringrequired

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

  • Minimum length: 2
createdAtstring

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

  • Format: date-time
updatedAtstring

The date and time when the enrollment was updated.

  • Format: date-time

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.

  • Format: date-time
statusLastUpdatedAtstringrequired

The date and time when the enrollment status was last updated. This timestamp is used to track enrollment processing durations and enables filtering to identify recently changed enrollments. It automatically updates whenever an enrollment's status changes but remains unchanged during other updates.

  • Format: date-time
historyarray<object>

The history of updates to this enrollment, such as status changes. This property is experimental and may change in the future.

Array item

The status before this change occurred. This will be UNDEFINED for the enrollment's initial status after creation.

Possible values
DRAFT
SUBMITTED
PROVISIONING
LIVE
REJECTED
history[].newStatusstringrequired

The status after this change occurred.

Possible values
DRAFT
SUBMITTED
PROVISIONING
LIVE
REJECTED
history[].changedBystringrequired

The source or system that triggered this change.

history[].changedAtstringrequired

The date and time when this change occurred.

  • Format: date-time
history[].typestringrequired

The type of change that occurred.

Possible values
STATUS_CHANGE
transactionseligibilityCheck | claimStatus | professionalClaimSubmission | institutionalClaimSubmission | dentalClaimSubmission | claimPayment | solicitedClaimAttachment | unsolicitedClaimAttachmentrequired

The type of transactions included in the enrollment.

Whether 270 Eligibility Checks are included in the enrollment.

Show attributes

Whether 276 Claim Status Requests are included in the enrollment.

Show attributes

Whether 837P Professional Claims are included in the enrollment.

Show attributes

Whether 837I Institutional Claims are included in the enrollment.

Show attributes

Whether 837D Dental Claims are included in the enrollment.

Show attributes

Whether 835 Electronic Remittance Advice (ERAs) are included in the enrollment.

Show attributes

Whether Solicited Claim Attachments are included in the enrollment.

Show attributes

Whether Unsolicited Claim Attachments are included in the enrollment.

Show attributes
userEmailstringrequired

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.

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

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.
Possible values
DRAFT
SUBMITTED
PROVISIONING
LIVE
REJECTED
sourcestring

The source of this enrollment.

Possible values
API
UI
IMPORT
reasonstring

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 notes about the enrollment. Only Stedi can read, set, or update this property.

This property is required for payers that require a Provider Transaction Access Number (PTAN).

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

  • Pattern: ^[a-zA-Z0-9]+$
  • Required string length: 5 - 10
providerobjectrequired

Information about the provider enrolling with the payer.

Show attributes

The provider's name, such as Example Dental Associates, LLC.

provider.idstringrequired

The Stedi-assigned identifier for the provider.

payerobjectrequired

Information about the payer the provider is enrolling with.

Show attributes

The payer's name, such as Cigna or UnitedHealthcare.

payer.stediPayerIdstringrequired

The unique Stedi assigned identifier for the payer.