List Enrollments

Lists transaction enrollment records with optional filtering and pagination.

GET /enrollments

This endpoint retrieves a list of all transaction enrollments in your Stedi account.

You can filter the results by various criteria, such as a query string (fuzzy matching is supported), enrollment status, creation date, provider names, provider NPIs, provider tax IDs, and Stedi payer IDs. When a query parameter is an array, you can include it more than once in the URL to filter by multiple values.

Query parameters	Endpoint returns
?providerNames=John%20Doe&providerNames=Jane%20Doe	Enrollments associated with either John Doe or Jane Doe.
?status=LIVE	Enrollments in LIVE status.
?filter=OS&createdFrom=2025-01-01T00:00:00Z	Enrollments with provider names, provider NPIs, provider tax IDs, or Stedi payer IDs containing os or OS. The search is case-insensitive, and fuzzy matching is supported. Enrollments created after 2025-01-01T00:00:00Z.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Query Parameters

pageSize · Number Range: ≥ 1 and ≤ 500

The maximum number of elements to return in a page. If not specified, the default is 100.

pageToken · String Length: 1 - 1024

An opaque token returned by a previous call to this endpoint in the nextPageToken property. You can use it to request the next page of results. If not specified, Stedi returns the first page of results.

filter · String

Filter for enrollments with properties matching a query string. You can provide all or part of a provider name, NPI, or tax ID. You can also provide all or part of a payer's Stedi payer ID - primary payer IDs and aliases aren't supported. The search is case-insensitive and supports fuzzy matching.

For example, providing ?filter=OS returns enrollments with provider.name containing os or OS (such as Joseph) and Stedi payer IDs containing OS, such as OSBLI for OptumHealth Salt Lake County.

status · Array of Strings

Filter for enrollments with specific statuses. You can include this parameter multiple times to filter for multiple statuses.

For example, ?status=LIVE&status=REJECTED returns enrollments that are in either LIVE or REJECTED status.

Possible values

DRAFT

SUBMITTED

PROVISIONING

LIVE

REJECTED

providerNpis · Array of Strings

Filter for enrollments associated with specific provider NPIs. You can include this parameter multiple times to filter for multiple NPIs.

For example, ?providerNpis=1234567890&providerNpis=0987654321 returns enrollments associated with either of the specified NPIs.

providerTaxIds · Array of Strings

Filter for enrollments associated with specific provider tax IDs. You can include this parameter multiple times to filter for multiple tax IDs.

For example, ?providerTaxIds=123456789&providerTaxIds=987654321 returns enrollments associated with either of the specified tax IDs.

providerNames · Array of Strings

Filter for enrollments associated with specific provider names. You can include this parameter multiple times to filter for multiple names.

For example, ?providerNames=John%20Doe&providerNames=Jane%20Doe returns enrollments associated with either John Doe or Jane Doe.

This search is case-sensitive and doesn't support fuzzy matching. The name you provide must match the provider's name exactly, including spaces and capitalization.

payerIds · Array of Strings

Filter for enrollments associated with specific Stedi payer IDs. You can include this parameter multiple times to filter for multiple payer IDs.

For example, ?payerIds=HGJLR&payerIds=EWDCI returns enrollments associated with either of the specified payer IDs.

This parameter only supports Stedi payer IDs, not primary payer IDs or aliases. It also doesn't support fuzzy matching. The payer ID you provide must match the Stedi payer ID exactly, including capitalization.

sources · Array of Strings

Filter for enrollments submitted through specific sources, such as the API or UI. You can include this parameter multiple times to filter for multiple sources.

For example, ?sources=API&sources=UI returns enrollments submitted through either of the specified sources.

Possible values

API

UI

IMPORT

AUTO_ENROLLMENT

transactions · Array of Strings

Filter for enrollments for specific transaction types. You can include this parameter multiple times to filter for multiple types.

For example, ?transactions=eligibilityCheck&transactions=claimStatus returns enrollments for both 270/271 eligibility checks and 276/277 real-time claim status.

Possible values

claimStatus

eligibilityCheck

institutionalClaimSubmission

professionalClaimSubmission

dentalClaimSubmission

createdFrom · String Format: date-time

Filter for enrollments created from a specific date.

For example, if you set this to 2025-01-01T00:00:00Z, Stedi returns enrollments with a createdAt timestamp on or after this date.

createdTo · String Format: date-time

Filter for enrollments created before a specific date.

For example, if you set this to 2025-01-01T00:00:00Z, Stedi only returns enrollments with a createdAt timestamp before this date.

The time must be later than createdFrom, if present.

statusUpdatedFrom · String Format: date-time

Filter for enrollments whose status was last updated from a specific date.

For example, if you set this to 2025-01-01T00:00:00Z, Stedi returns enrollments with a statusLastUpdatedAt timestamp on or after this date.

statusUpdatedTo · String Format: date-time

Filter for enrollments whose status was last updated before a specific date.

For example, if you set this to 2025-01-01T00:00:00Z, Stedi only returns enrollments with a statusLastUpdatedAt before this date.

The time must be later than statusUpdatedFrom, if present.

importId · String

The import ID associated with an enrollment through a CSV bulk import. This ID is only available for enrollments created through the CSV import process.

sortBy · Array of Strings

Sort the results by one or more properties. By default, Stedi sorts results by the createdAt property in descending order.

Supply a query string with each property appended using &. Each property must be provided in a property:direction format, where property is the name of the property to sort by and direction is the sort direction, either asc (ascending) or desc (descending).

• When you don't include id, Stedi automatically adds it as the final sort criterion to ensure deterministic results.
• When you provide multiple properties, Stedi sorts by their order in the query string. For example, if you provide ?sortBy=updatedAt:desc&sortBy=id:asc, Stedi sorts first by updatedAt in descending order. If multiple records share the same updatedAt date, Stedi then sorts those records by id in ascending order.

Supported properties: updatedAt, statusLastUpdatedAt, id

Examples:

• Sort by updatedAt in descending order: ?sortBy=updatedAt:desc
• Sort by statusLastUpdatedAt in ascending order: ?sortBy=statusLastUpdatedAt:asc
• Sort by updatedAt and then by id: ?sortBy=updatedAt:desc&sortBy=id:asc

Response

application/json

ListEnrollments 200 response

nextPageToken · String Length: 1 - 1024

Token for pagination to retrieve the next page of results; null if there are no more results

items · Array of Objects

Details about the enrollments matching the search criteria.

id · items[].id · String Required

The Stedi-assigned identifier for the enrollment.

provider · items[].provider · Object Required

Information about the provider enrolling with the payer.

name · items[].provider.name · String Required

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

npi · items[].provider.npi · String Required

The provider's National Provider Identifier (NPI). This is a 10-digit number assigned by the Centers for Medicare & Medicaid Services (CMS) to healthcare providers in the United States. It is used to identify providers in healthcare transactions.

taxId · items[].provider.taxId · String Required

The provider's tax identification number (SSN or EIN). This is used to identify the provider for tax and administrative purposes.

taxIdType · items[].provider.taxIdType · String Required

The type of tax identification number. This indicates whether the tax ID is a Social Security Number (SSN) or Employer Identification Number (EIN).

id · items[].provider.id · String Required

The Stedi-assigned identifier for the provider. The Create Provider endpoint returns this as the id property.

payer · items[].payer · Object Required

Information about the payer the provider is enrolling with.

name · items[].payer.name · String

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

stediPayerId · items[].payer.stediPayerId · String Required

The unique Stedi assigned identifier for the payer.

submittedPayerIdOrAlias · items[].payer.submittedPayerIdOrAlias · String

The payer ID or alias used when creating the enrollment request. For example, 62308 and CIGNA are both supported for Cigna. You can find a list of all supported payer IDs and aliases in the Payer Network.

transactions · items[].transactions · Object Required

The type of transactions included in the enrollment.

eligibilityCheck · items[].transactions.eligibilityCheck · Object Required

Whether 270 eligibility checks are included in the enrollment.

enroll · items[].transactions.eligibilityCheck.enroll · Boolean Required

status · items[].status · String Required

The status of the enrollment.

• DRAFT - You are still editing the record and it has not been submitted to Stedi.
• STEDI_ACTION_REQUIRED - You have submitted the enrollment and it is ready for Stedi to begin processing.
• PROVIDER_ACTION_REQUIRED - The enrollment requires action from the healthcare provider to proceed, such as providing additional documentation. Stedi will add a note to your enrollment request with clear instructions.
• SUBMITTED - (Deprecated) Legacy status being phased out in favor of the more specific action-required statuses.
• 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

source · items[].source · String Required

The source of the enrollment.

Possible values

API

UI

IMPORT

AUTO_ENROLLMENT

createdAt · items[].createdAt · String Required Format: date-time

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

updatedAt · items[].updatedAt · String Required Format: date-time

The date and time when the enrollment was updated.

submittedAt · items[].submittedAt · String 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.

statusLastUpdatedAt · items[].statusLastUpdatedAt · String Required Format: date-time

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.

history · items[].history · Array of Objects

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

previousStatus · items[].history[].previousStatus · String

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

newStatus · items[].history[].newStatus · String Required

The status after this change occurred.

Possible values

DRAFT

SUBMITTED

PROVISIONING

LIVE

REJECTED

changedBy · items[].history[].changedBy · String Required

The source or system that triggered this change.

changedAt · items[].history[].changedAt · String Required Format: date-time

The date and time when this change occurred.

type · items[].history[].type · String Required

The type of change that occurred.

Possible values

STATUS_CHANGE

documents · items[].documents · Array of Objects

Documents associated with this enrollment, such as signed enrollment forms. This list doesn't include deleted documents.

Each document object contains metadata such as the document's name, status, and timestamps for creation and last update.

id · items[].documents[].id · String Required

The unique identifier for the document.

enrollmentId · items[].documents[].enrollmentId · String Required

The enrollment ID this document is associated with.

name · items[].documents[].name · String Required

The name of the document.

contentType · items[].documents[].contentType · String

The content type of the document.

size · items[].documents[].size · Number

The size of the document in bytes.

status · items[].documents[].status · String Required

Indicates whether the document file has been successfully uploaded to Stedi.

Possible values

PENDING

UPLOADED

FAILED

DELETED

taskId · items[].documents[].taskId · String

The task ID associated with this document, if it was created or processed as part of a task.

createdAt · items[].documents[].createdAt · String Required Format: date-time

The date and time when the document was created.

updatedAt · items[].documents[].updatedAt · String Required Format: date-time

The date and time when the document was last updated.

tasks · items[].tasks · Array of Objects

Tasks associated with this enrollment, such as reminders or follow-ups.

responsibleParty · items[].tasks[].responsibleParty · String Required

The party responsible for completing this task.

Possible values

PROVIDER

STEDI

definition · items[].tasks[].definition · Object Required

A definition that determines the task's behavior, requirements, and data.

followInstructions · items[].tasks[].definition.followInstructions · Object Required

A task that requires the responsible party to follow specific instructions.

instructions · items[].tasks[].definition.followInstructions.instructions · String Required Min length: 1

Human-readable instructions for the responsible party to follow.

rank · items[].tasks[].rank · Number Required Range: ≥ 0

The rank order of this task. Tasks with lower numbers must be completed first. For example, a task with rank 1 must be completed before a task with rank 2.

completedAt · items[].tasks[].completedAt · String Format: date-time

The timestamp when the task was completed.

responseData · items[].tasks[].responseData · Object

Data collected when the task was completed. This object currently only applies to tasks with definition.provideInformation.

provideInformation · items[].tasks[].responseData.provideInformation · Object Required

Provide notes or confirmation text to Stedi.

response · items[].tasks[].responseData.provideInformation.response · String Required Min length: 1

Notes or confirmation text from the responsible party in response to completing a ProvideInformation task.

isComplete · items[].tasks[].isComplete · Boolean Required

Whether the task has been marked as complete through either the API or the Stedi portal.

id · items[].tasks[].id · String Required

The unique, Stedi-assigned identifier for the task.

importId · items[].importId · String

The import ID associated with the enrollment if it was created through a CSV bulk import (source is set to IMPORT). This property is only present for enrollments created through the CSV import process.

totalCount · Number

The total count of enrollments matching the filter criteria, regardless of pagination.

Request

curl --request GET \
  --url "https://enrollments.us.stedi.com/2024-09-01/enrollments" \
  --header "Authorization: <api_key>"

Response

{
  "nextPageToken": "945ff6de213d3ef481d028065d4c12fb996a166a3a90ef98564318decfae50ce4b36d74b7e9d9bafa6e1d169",
  "totalCount": 42,
  "items": [
    {
      "id": "db6675c5-7bg7-4af9-8c68-a54a336d2911",
      "provider": {
        "name": "Test Medical Provider",
        "id": "db6665c5-7b97-4af9-8c68-a00a336c2998",
        "npi": "1234567890",
        "taxId": "123456789",
        "taxIdType": "EIN"
      },
      "payer": {
        "name": "UnitedHealthcare",
        "stediPayerId": "KMQTZ",
        "submittedPayerIdOrAlias": "87726"
      },
      "transactions": {
        "claimPayment": {
          "enroll": true
        }
      },
      "status": "LIVE",
      "source": "API",
      "statusLastUpdatedAt": "2025-05-01T12:00:00Z",
      "createdAt": "2025-04-01T12:00:00Z",
      "updatedAt": "2025-05-01T12:00:00Z",
      "documents": [
        {
          "id": "dc6665a5-7b97-4agh-8c74-a00a336c2989",
          "enrollmentId": "db6675c5-7bg7-4af9-8c68-a54a336d2911",
          "status": "UPLOADED",
          "name": "pdf-agreement.pdf",
          "createdAt": "2025-04-01T12:00:00Z",
          "updatedAt": "2025-04-02T12:00:00Z"
        }
      ],
      "history": [
        {
          "newStatus": "DRAFT",
          "changedBy": "user@example.com",
          "changedAt": "2025-04-15T09:00:00Z",
          "type": "STATUS_CHANGE"
        },
        {
          "previousStatus": "DRAFT",
          "newStatus": "SUBMITTED",
          "changedBy": "user@example.com",
          "changedAt": "2025-04-15T09:05:00Z",
          "type": "STATUS_CHANGE"
        },
        {
          "previousStatus": "SUBMITTED",
          "newStatus": "PROVISIONING",
          "changedBy": "system",
          "changedAt": "2025-04-20T14:30:00Z",
          "type": "STATUS_CHANGE"
        },
        {
          "previousStatus": "PROVISIONING",
          "newStatus": "LIVE",
          "changedBy": "system",
          "changedAt": "2025-05-01T12:00:00Z",
          "type": "STATUS_CHANGE"
        }
      ],
      "tasks": [
        {
          "id": "ac6665a5-7b97-4agh-8c74-a00a336c2989",
          "responsibleParty": "PROVIDER",
          "isComplete": false,
          "rank": 0,
          "definition": {
            "followInstructions": {
              "instructions": "Upload a document to support your enrollment."
            }
          }
        }
      ]
    }
  ]
}