---
title: "Get the statuses of a list of batches"
method: GET
path: "/scabbard/{circuit}/{service_id}/batch_statuses"
tags: ["Scabbard"]
---

# Get the statuses of a list of batches

`GET /scabbard/{circuit}/{service_id}/batch_statuses`

This endpoint can be used to check the status of one or more batches
that were submitted to a Scabbard service. The IDs of the batches to
check should be specified with the `ids` query parameter. The `wait`
query parameter requests that the server wait for the given number of
seconds for the batches to be committed; however, this wait time is not
guaranteed.

This endpoint requires the permission "scabbard.read".

## Path parameters

- `circuit` string, required
- `service_id` string, required

## Query parameters

- `ids` string, required
- `wait` integer

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

The statuses of the batches were successfully retrieved

- BatchStatus[]
  - `id` string — The batch's ID
  - `status` object — Batch status
    - `statusType` 'Unknown' | 'Invalid' | 'Valid' | 'Pending' | 'Committed'
    - `message` object[]
      - `transaction_id` string
      - `error_message` string
      - `error_data` integer[]

## Other responses

- `400` — The request was malformed or no batch IDs were provided
- `401` — The client is unauthorized
- `404` — The scabbard service with the given circuit and service id was not found
- `408` — The batches were not committed before the specified wait time
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)