STstedi
Batch eligibility check

POST /eligibility-manager/batch-eligibility

Changed on

Submit multiple eligibility checks for Stedi to process asynchronously

Request

  • Base URL
    https://manager.us.stedi.com/2024-04-01
  • URL
    https://manager.us.stedi.com/2024-04-01/eligibility-manager/batch-eligibility
  • Auth
    API key in header Authorization

Headers

X-Forwarded-Forstring

(CMS requests only): Starting November 8, 2025, the Centers for Medicare & Medicaid Services (CMS) requires submitters to include network IP addresses from an eligibility request's point of origin through receipt by the HETS system. To comply with this requirement, you may need to include this header in requests to CMS.

When present, this header should contain a comma-separated list of upstream IP addresses, starting with the originating system and continuing through every intermediary. You can exclude your IP address from the list. Note that Stedi blocks eligibility requests to CMS when any IP address in the chain – the originating IP address or any in the X-Forwarded-For header – is located outside the United States.

Visit CMS traceability requirements for details and examples.

Request body

maxRetryHoursinteger

The maximum number of hours that Stedi will retry eligibility checks in this batch that fail due to payer connectivity issues. Must be an integer between 8 and 24 hours. If not specified, the default is 8 hours.

namestring

The name that Stedi will use when displaying this batch on the Eligibility check batches page. It must be unique within your Stedi account. If you don't specify a name, Stedi sets this property to the autogenerated batchId returned in the response.

Response

BatchEligibilityChecks 200 response

batchIdstring required

An identifier for this batch of eligibility checks. You can use this identifier to retrieve the results of this batch using the Poll Batch Eligibility Checks endpoint.

submittedAtstring date-time required

The date and time that the batch of eligibility checks was submitted to Stedi for processing.

Changes