---
title: "List items for an internal transfer batch"
method: GET
path: "/v1/batches/{batchUuid}/internaltransfers"
tags: ["Batch Payments"]
---

# List items for an internal transfer batch

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

This endpoint returns returns a paginated list of items in the specified batch. You will need to enable PERM_BUSINESS_GET_BATCH_INTERNALTRANSFERS 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` BatchItemInternalTransfer[]
    - `batchItemUuid` string — A UUID for this item.
    - `status` 'SUBMITTED' | 'REMOVED' | 'SUCCEEDED' | 'FAILED' — status of the batch if internal trasnfer
    - `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
    - `feeAmount` integer — The fee charged by fire.com for the payment. In pence or cent.
    - `taxAmount` integer — Any taxes/duty collected by fire.com for this payments (e.g. stamp duty etc). In pence or cent.
    - `amountAfterCharges` integer — The amount of the transfer after fees and taxes. in pence or cent.
    - `icanFrom` integer — The Fire account ID of the source account.
    - `icanTo` integer — The Fire account ID for the fire.com account the funds are sent to.
    - `amount` integer — The amount of funds to send. In cent or pence
    - `ref` 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.

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