POST
/
eligibility-manager
/
batch-eligibility
cURL
curl --request POST \
  --url https://manager.us.stedi.com/2024-04-01/eligibility-manager/batch-eligibility \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "march-2024-eligibility-batch",
  "items": [
    {
      "submitterTransactionIdentifier": "ABC123456789",
      "controlNumber": "000022222",
      "tradingPartnerServiceId": "AHS",
      "encounter": {
        "serviceTypeCodes": [
          "MH"
        ]
      },
      "provider": {
        "organizationName": "ACME Health Services",
        "npi": "1234567891"
      },
      "subscriber": {
        "dateOfBirth": "19000101",
        "firstName": "Jane",
        "lastName": "Doe",
        "memberId": "1234567890"
      }
    },
    {
      "submitterTransactionIdentifier": "DEF123456799",
      "controlNumber": "333344444",
      "tradingPartnerServiceId": "AHS",
      "encounter": {
        "serviceTypeCodes": [
          "78"
        ]
      },
      "provider": {
        "organizationName": "ACME Health Services",
        "npi": "1234567891"
      },
      "subscriber": {
        "dateOfBirth": "19001021",
        "firstName": "John",
        "lastName": "Doe",
        "memberId": "1234567892"
      }
    }
  ]
}'
{
  "batchId": "01928d19-df25-76c0-8d51-f5351260fa05",
  "submittedAt": "2023-11-07T05:31:56Z"
}
You may want to periodically conduct asynchronous batch eligibility checks for your entire patient population or a subset of patients, such as those who have active care plans or who have future services scheduled. These data refreshes allow you to proactively reach out to patients when they lose or change coverage.
  • Call this endpoint with a JSON payload containing one or more eligibility checks. You can submit up to 1,000 individual eligibility checks within a single batch, and you can submit as many batches as you need to process.
  • The endpoint returns a synchronous response containing a batchId that you can use to retrieve the results of these checks later, using the Poll Batch Eligibility Checks endpoint.
  • Stedi translates each eligibility check included in the request to the X12 270 EDI format and sends it to the appropriate payer.
Visit Batch refresh checks for a complete how-to guide.

​
Start with real-time checks

Batch checks have a longer feedback cycle than real-time checks because you don’t receive the payer’s response immediately. That’s why we strongly recommend starting with real-time checks when integrating with a new payer or working with eligibility checks for the first time. To perform synchronous eligibility checks, use the Real-Time Eligibility Check endpoint.

Authorizations

​
Authorization
string
header
required

A Stedi API Key for authentication.

Body

application/json

Response

200
application/json

BatchEligibilityChecks 200 response

The response is of type object.