---
title: "Get full batch transfer information with transfer items by given ID"
method: GET
path: "/v1/a2a/batches/{id}"
tags: ["Account to account batch transfer"]
---

# Get full batch transfer information with transfer items by given ID

`GET /v1/a2a/batches/{id}`

This operation will respond with a batch transfer and a list of transfer items for the given batch transfer ID.

## Path parameters

- `id` string, required

## Query parameters

- `auditUser` string, required
- `exclusiveStartKey` object
  - `batchTransferId` string
  - `status` string
  - `transferId` string
- `size` integer

## Response `200`

Successful lookup of batch transfer

- BatchTransferResponse
  - `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.
  - `transfers` object, required
    - `lastEvaluatedKey` object — Key used for pagination. Use these values in the request for exclusiveStartKey to fetch the next page.
      - `batchTransferId` string, required
      - `status` string, required
      - `transferId` string, required
    - `size` integer, required — Number of items returned in the response
    - `items` BatchTransferTransferItem[], required — An array of transfer items
      - `id` string, required — Enfuce generated id for transfer. Id is recorded to the add_info fields in the crediting and debiting transactions as reference (available in Data export transaction files).
      - `creditTransaction` TransactionInfo
        - `id` string, biginteger — transaction id
        - `errorMessage` string — Contains short description of error if happened
      - `debitTransaction` TransactionInfo
        - `id` string, biginteger — transaction id
        - `errorMessage` string — Contains short description of error if happened
      - `reversalTransaction` TransactionInfo
        - `id` string, biginteger — transaction id
        - `errorMessage` string — Contains short description of error if happened
      - `status` 'COMPLETED' | 'FAILED_BUT_REVERSED' | 'DEBIT_FAILED' | 'FAILED_BUT_NOT_REVERSED', required — Final transfer status. `COMPLETED` - succsessfully completed transfer, debitTransaction and creditTransaction info will be returned. `DEBIT_FAILED` - failed to do debit transaction, aborting transfer. Failed debit transaction id will be returned. `FAILED_BUT_REVERSED` - failed to transfer money, but reversed debit transaction. Debit, credit and reversal info will be returned. `FAILED_BUT_NOT_REVERSED` - unexpected error. Debit part done, crediting - failed, and failed to reverse debit. Manual interaction is required to fix.
      - `type` 'A2A' | 'C2C', required — Transfer type. `A2A` - Account to account, `C2C` - Card to card.
      - `fromId` string, biginteger, required — Id of account from which balance was debited
      - `toId` string, biginteger, required — Id of account from which balance was credited
      - `amount` number, required — Transfer amount
      - `currency` string, required — Currency of the amount in ISO 4217 (Alpha code) format

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