---
title: "List items for a bank transfer batch"
method: GET
path: "/v1/batches/{batchUuid}/banktransfers"
tags: ["Batch Payments"]
---

# List items for a bank transfer batch

`GET /v1/batches/{batchUuid}/banktransfers`

This endpoint returns a paginated list of items in the specified batch. You will need to enable PERM_BUSINESS_GET_BATCH_BANKTRANSFERS to use this endpoint.

## Path parameters

- `batchUuid` string, required — The uuid of the batch.

## Query parameters

- `offset` integer — The page offset. Defaults to 0. This is the record number that the returned list will start at. E.g. offset = 40 and limit = 20 will return records 40 to 59.
- `limit` integer — The number of records to return. Defaults to 10 - max is 200.

## Response `200`

A fire.com list object of Batch Items (Internal transfers or Bank transfers).

- object
  - `total` integer — total number of batches returned
  - `items` BatchItemBankTransfer[]
    - `batchItemUuid` string — A UUID for this item.
    - `status` 'Submitted' | 'Removed' | 'Suceeded' | 'Failed'
    - `result` object — The outcome of the attempted transaction.
      - `code` integer
      - `message` string
    - `dateCreated` string, date-time — The datestamp the batch was created - ISO format - e.g. 2018-04-04T00:53:21.910Z
    - `lastUpdated` string, date-time — The datestamp of the last action on this batch - ISO format - e.g. 2018-04-04T10:48:53.540Z
    - `icanFrom` integer — The Fire account ID of the source account.
    - `amount` integer — The amount of funds to send. In cent or pence
    - `myRef` string — The reference on the transaction.
    - `yourRef` string — The reference on the transaction.
    - `refId` integer — The ID of the resulting payment in your account. Can be used to retrieve the transaction using the https://api.fire.com/business/v1/accounts/{accountId}/transactions/{refId} endpoint.
    - `payeeType` 'ACCOUNT_DETAILS' | 'PAYEE_ID' — The type of payee information
    - `payeeId` integer — The ID for the named payee
    - `destIban` string — The IBAN for the payee's account
    - `destAccountHolderName` string — The payee's name
    - `payeeCheckStatus` 'FULL_MATCH' | 'PARTIAL_MATCH' | 'NO_MATCH' | 'UNABLE_TO_MATCH' — The status of the VoP check for this payee
    - `payeeCheckPartialMatchName` string — The result of the VoP check for the payee. Displayed if the VoP result is PARTIAL_MATCH

## Other responses

- `400` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `401` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `403` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.

---

[API](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api.md) · [All operations](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefinancialservices/fire-financial-services-business-api/revisions/1d19896d095c/schema)