# Introducing API endpoints for batch status checks

> You can now check the progress of batch eligibility checks with two new API endpoints. These endpoints let you track a batch's status without polling.

Published Nov 18, 2025

Updated Nov 11, 2026

Category: Products

Batch eligibility checks let you run multiple checks asynchronously using a single request.

Now, you can check the progress of those batches with two new API endpoints:

- **Retrieve Batch Check Status** – Shows the overall status of a batch, including counts for completed and in-progress checks.

- **Retrieve Batch Check Statuses** – Shows the status of each individual check in a batch.

Previously, there wasn’t a simple, programmatic way to check how far along a batch was. The [Poll Batch Eligibility Checks endpoint](https://www.stedi.com/docs/healthcare/api-reference/get-healthcare-polling-eligibility) lets you poll for results, but it only returns completed checks. To know if a batch was done, you had to write logic to compare the completed checks to the total you submitted for each batch.

The new endpoints handle the tracking for you.

## Retrieve Batch Check Status endpoint

Use this endpoint to see the status of a batch you’ve submitted, either through the [Batch Eligibility Checks API](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-batch-eligibility) or a [CSV upload](https://www.stedi.com/docs/healthcare/batch-refresh-eligibility-checks-ui#upload-csv-file) in the Stedi portal. Include the batch ID returned by the batch request:

```jsx
curl https://manager.us.stedi.com/2024-04-01/eligibility-manager/batch/<batch-id> \
  -H "Authorization: <api_key>"
```

The response shows an overall status and counts for completed and in-progress checks. You can use both to decide when to start polling for results. For example, you may only poll once the `successCount` is greater than zero or when `status` is `COMPLETED`.

```jsonc
{
  "batchType": "ELIGIBILITY",
  "status": "IN_PROGRESS",
  "totalCount": 10000,
  "successCount": 2400,
  "errorCount": 15,
  "inProgressCount": 7585,
  "createdAt": "2025-11-06T14:26:01.821Z",
  "updatedAt": "2025-11-06T14:46:13.119Z"
}
```

For more details, see the [Retrieve Batch Check Status](https://www.stedi.com/docs/healthcare/api-reference/get-healthcare-batch-eligibility-status) API reference.

## Retrieve Batch Check Statuses endpoint

This endpoint shows the state of each check within a batch. Use it to see whether specific checks in a batch have finished processing.

```jsx
curl https://manager.us.stedi.com/2024-04-01/eligibility-manager/batch/<batch-id>/items \
  -H "Authorization: <api_key>"
```

The response includes each patient’s eligibility check result (`eligibilityCheckResult`) and member ID (`subscriberMemberId`). If you only need to confirm that information, you can skip polling altogether.

```jsonc

{
  "items": [
    {
      "batchId": "<batch-id>",
      "state": "COMPLETED",
      "requestId": "...",
      "additionalInfo": {
        "eligibility": {
          "eligibilitySearchId": "...",
          "eligibilityCheckResult": "ACTIVE",
          "subscriberFirstName": "John",
          "subscriberLastName": "Doe",
          "subscriberMemberId": "12345678",
          "providerName": "STEDI",
          "providerNpi": "1999999984",
          "outboundTraceId": "...",
          "submitterTransactionIdentifier": "00001",
          "payerId": "FRCPB"
        }
      },
      "createdAt": "2025-11-06T14:26:01.931Z",
      "updatedAt": "2025-11-06T14:26:13.097Z",
      "index": 0
    }
  ],
  "nextPageToken": "..."
}
```

For more details, see the [Retrieve Batch Check Statuses](https://www.stedi.com/docs/healthcare/api-reference/get-healthcare-batch-eligibility-check-statuses) API reference.

## When to use batch eligibility checks

Use [real-time eligibility checks](https://www.stedi.com/docs/healthcare/send-eligibility-checks) for checks that need results in seconds, like when a patient is at the front desk. For bulk checks that aren’t time sensitive, like monthly refreshes, use [batch checks](https://www.stedi.com/docs/healthcare/batch-refresh-eligibility-checks). They handle queuing and retries over longer periods for you.

For details, see [How and why to move to batch eligibility checks](https://www.stedi.com/blog/how-and-why-to-move-to-batch-eligibility-checks).

## Get started

If you want help implementing batch eligibility checks, [schedule a consultation](https://www.stedi.com/contact). We’ll help you design a scalable workflow that fits your use case.
