---
title: "Get all batch transfers"
method: GET
path: "/v1/a2a/batches"
tags: ["Account to account batch transfer"]
---

# Get all batch transfers

`GET /v1/a2a/batches`

This operation will respond with a list of batch transfers for the institution defined by the authenticated user's context.

## Query parameters

- `auditUser` string, required
- `exclusiveStartKey` object
  - `institutionId` string
  - `startTime` string
  - `id` string
- `size` integer

## Response `200`

Successful lookup of batch transfers

- BatchTransfersResponse
  - `lastEvaluatedKey` object — Key used for pagination. Use these values in the request for exclusiveStartKey to fetch the next page.
    - `institutionId` string, required
    - `startTime` string, required
    - `id` string, required
  - `size` integer, required — Number of items returned in the response
  - `items` BatchTransferResponseWithoutTransferItems[], required — An array of batch transfers
    - `id` string, required — Enfuce generated id for batch transfer.
    - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_ERRORS', required — Batch transfer status. `IN_PROGRESS` - Successfully created but not yet complited batch transfer. `COMPLETED` - Successfully completed batch transfer. `FAILED` - Completely or partially failed batch transfer.
    - `description` string — Free form description.
    - `startTime` string, date-time, required
    - `transferItemCount` integer, required — Number of transfer items in the batch.
    - `totalAmount` object — Map of total amount per currency.
    - `completionTime` string, date-time
    - `successfulTransferItems` integer — Number of successful transfer items in the batch.
    - `failedTransferItems` integer — Number of failed transfer items in the batch.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — API is having problems

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)