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

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

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

Retrieve the status of an eligibility check batch submitted through the API or CSV upload

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

## Response `200`

GetBatch 200 response

- GetBatchResponseContent
  - `batchType` 'ELIGIBILITY', required — The type of batch.
  - `createdAt` string, date-time, required — The date and time when the batch was created.
  - `errorCount` integer — The number of eligibility checks that failed during processing. A failure means that Stedi successfully processed the check but didn't receive a response from the payer, even after retrying. A common reason for failure is payer connectivity issues.
  - `id` 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.
  - `importUrl` string — The URL to download the original CSV file. Only relevant for batches submitted through CSV upload in the Stedi portal.
  - `inProgressCount` integer — The number of eligibility checks that are currently in progress (started or retrying).
  - `maxRetryHours` integer — The maximum number of hours that Stedi will retry eligibility checks in this batch that fail due to payer connectivity issues. This is the value that was set when the batch was created. Only applicable to batches submitted through the API.
  - `name` string, required — The name assigned to the batch upon creation. For CSV uploads, this is the name you provided when uploading the file. For API submissions, this is the same as the `batchId`.
  - `source` 'CSV_IMPORT' | 'API'
  - `status` 'PENDING' | 'VALIDATED' | 'VALIDATION_FAILED' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS', required — The status of the batch.
  - `successCount` integer — The number of eligibility checks that were successfully completed. This means that Stedi successfully sent the check to the payer and received a response, but doesn't indicate whether the payer returned benefits information.
  - `totalCount` integer — The total number of eligibility checks in the batch. In the case of CSV uploads, one row in the CSV file corresponds to one eligibility check.
  - `updatedAt` string, date-time, required — The date and time when the batch was last updated.
  - `validatedCount` integer — The number of eligibility checks that Stedi has validated.
  - `validationFailedCount` integer — The number of eligibility checks that failed validation. This is relevant to CSV uploads, where Stedi validates each row in the CSV file before processing it.

## 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/revisions/9951542b4602/schema)