---
title: "GET /eligibility-manager/batch/{batchId}/items"
method: GET
path: "/eligibility-manager/batch/{batchId}/items"
tags: ["Batch eligibility check"]
---

# GET /eligibility-manager/batch/{batchId}/items

`GET /eligibility-manager/batch/{batchId}/items`

Retrieve status information for all eligibility checks within a batch, regardless of processing status

## Path parameters

- `batchId` string, required — The unique identifier for the batch. This is the `batchId` returned in the Batch Eligibility Check endpoint response. It's also listed as the **Batch ID** in the Stedi portal.

## Query parameters

- `pageSize` integer — The maximum number of elements to return in a page. If not specified, the default is 100.
- `pageToken` string — A token returned by a previous call to this operation in the `nextPageToken` property. If not specified, Stedi returns the first page of results.
- `state` BatchItemState[] — Filter for batch items in the specified states. Can be set to one or more of the following states: - `PENDING`: Stedi hasn't begun processing the eligibility check. - `VALIDATED`: Stedi finished validating the eligibility check and is ready to execute it. - `VALIDATION_FAILED`: Stedi found errors in the eligibility check that you need to fix before processing can continue. - `STARTED`: Stedi has begun processing the eligibility check. - `RETRYING`: Stedi is retrying the eligibility check. Stedi retries eligibility checks that fail due to payer connectivity issues for up to 8 hours. - `COMPLETED`: Stedi successfully processed the eligibility check and received a response from the payer. This doesn't indicate that the payer has active coverage, only that Stedi was able to get a response. - `COMPLETED_WITH_ERRORS`: Stedi finished processing the eligibility check, but couldn't get a response from the payer.
- `eligibilityCheckResult` EligibilityCheckResult[] — Filter for batch items with the specified eligibility check results. Can be set to one or more of the following results: - `ACTIVE`: The payer's response contains an active eligibility and benefit type. Visit [Eligibility and benefit type codes](https://www.stedi.com/docs/healthcare/supported-features/eligibility-and-benefit-type-codes) for a complete list of valid code values. - `INACTIVE`: The payer's response doesn't contain an active eligibility and benefit type. - `INVESTIGATE`: The payer returned an unexpected eligibility or benefit type code. Review the response and contact the payer if you have questions. - `FAILED`: The payer returned an error code in the response. Review the error code and retry the eligibility check.

## Response `200`

GetBatchItems 200 response

- GetBatchItemsResponseContent — Common output structure for list operations with pagination support.
  - `items` BatchItem[] — A list of batch items. Each `item` represents a single eligibility check in the batch. Unlike the polling endpoint, which only returns results for completed eligibility checks, this endpoint returns results for all eligibility checks in the batch, regardless of their processing status. All batch items may not be returned in a single response; use the `nextPageToken` to retrieve subsequent pages of results.
    - `additionalInfo` BatchItemAdditionalInfo — Additional information about the batch item, based on the batch type.
      - `eligibility` EligibilityBatchItemInfo, required — Additional information specific to eligibility batch items.
        - `aaaErrors` EligibilityCheckError[] — When a payer rejects your eligibility check, the response contains one or more [`AAA` errors](https://www.stedi.com/docs/healthcare/eligibility-troubleshooting#payer-aaa-errors) that specify the reasons for the rejection and any recommended follow-up actions. Any errors that occur at the `payer`, `provider`, `subscriber`, or `dependents` levels are also included in this array, allowing you to review all errors in a central location. If there are no `AAA` errors, this array will be empty.
          - `code` '04' | '15' | '33' | '35' | '41' | '42' | '43' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '97' | '98' | 'AA' | 'AE' | 'AF' | 'AG' | 'AO' | 'CI' | 'E8' | 'IA' | 'MA' | 'T4' — This is a superset of all the possible codes in the sub-loops, as all errors are bubbled up to the top level of the response Payers may sometimes return other non-compliant values.
          - `description` string — The error description.
          - `field` string — The error type, `AAA`.
          - `followupAction` 'Please Correct and Resubmit' | 'Resubmission Not Allowed' | 'Please Resubmit Original Transaction' | 'Resubmission Allowed' | 'Do Not Resubmit; Inquiry Initiated to a Third Party' | 'Please Wait 30 Days and Resubmit' | 'Please Wait 10 Days and Resubmit' | 'Do Not Resubmit; We Will Hold Your Request and Respond Again Shortly' — Payers may sometimes return other non-compliant values.
          - `location` string — The location of the error within the original X12 EDI response.
          - `possibleResolutions` string — Information to help you correct the error. We periodically update this guidance, so these strings may change at any time and may differ between eligibility responses. **Don't build programmatic logic that depends on matching these strings exactly.**
        - `eligibilityCheckResult` 'ACTIVE' | 'INACTIVE' | 'INVESTIGATE' | 'FAILED'
        - `eligibilitySearchId` string — The eligibility search ID for this eligibility check. This is an identifier that allows Stedi to group eligibility checks for the same patient into a unified record in the Stedi portal called an [eligibility search](https://www.stedi.com/docs/healthcare/eligibility-searches-view). This property is for use by Stedi tools only, such as Stedi's MCP server.
        - `id` string — The unique identifier for this eligibility check. This is the ID of the specific eligibility check request within the batch.
        - `outboundTraceId` string — A unique Stedi-generated identifier for the eligibility check. It's required for the generated X12 EDI transaction Stedi sends to payers. This identifier is different from the `requestId` and the `submitterTransactionIdentifier`. - You can use this identifier to find an eligibility check in the Stedi portal. Click **Find by ID** in the navigation bar and enter the `outboundTraceId` to go directly to the eligibility check's details page. - Don't use this ID to correlate eligibility check requests and responses. Use the `submitterTransactionIdentifier` property for correlation and tracking instead.
        - `payerId` string — The payer ID for this eligibility check.
        - `providerName` string — The provider's name as provided in the eligibility check.
        - `providerNpi` string — The provider's NPI as provided in the eligibility check.
        - `submitterTransactionIdentifier` string — The unique identifier you assigned to the eligibility check when you submitted the batch. Stedi also returns this identifier in the [Poll Batch Eligibility Checks](https://www.stedi.com/docs/healthcare/api-reference/get-healthcare-polling-eligibility) endpoint response, allowing you to correlate eligibility check requests and responses.
        - `subscriberFirstName` string — The subscriber's first name as provided in the eligibility check.
        - `subscriberLastName` string — The subscriber's last name as provided in the eligibility check.
        - `subscriberMemberId` string — The subscriber's member ID as provided in the eligibility check.
    - `batchId` string, required — The ID for the batch containing this eligibility check.
    - `createdAt` string, date-time, required — The date and time when the eligibility check was created.
    - `index` integer — Only relevant for batches submitted through the JSON API. This is the index of the item in the batch. It starts at 0.
    - `requestId` string — A globally unique identifier for this eligibility check within Stedi. Stedi uses this identifier to construct the URL for the eligibility check's detail pages within the Stedi portal. Don't use this ID to correlate eligibility check requests and responses. Use the `additionalInfo.eligibility.submitterTransactionIdentifier` property for correlation and tracking instead.
    - `rowNumber` integer — Only relevant for batches submitted through CSV upload. This is the row number for this eligibility check in the CSV file. It starts at 2 because the first row of the CSV file is the header.
    - `state` 'PENDING' | 'VALIDATED' | 'VALIDATION_FAILED' | 'STARTED' | 'RETRYING' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS', required — The current state of a batch item, which represents an eligibility check within a batch.
    - `updatedAt` string, date-time, required — The date and time when the eligibility check was last updated.
  - `nextPageToken` string — Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.

## Other responses

- `400` — ValidationException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `500` — InternalFailureException 500 response

---

[API](https://skmtc.net/stedi/apis/stedi-manager.md) · [All operations](https://skmtc.net/stedi/apis/stedi-manager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-manager/versions/9951542b4602/schema)