---
title: "Add an international transfer to a Batch"
method: POST
path: "/v2/batches/{batchUuid}/internationaltransfers"
tags: ["Batch Payments"]
---

# Add an international transfer to a Batch

`POST /v2/batches/{batchUuid}/internationaltransfers`

This endpoint allows you to add an international transfer to a batch. International transfers must be added to a batch using the Payee ID (**Mode 1**). Payees must be set up using the web application.

**Mode 1:** Use the payee IDs of existing approved payees set up against your account. These batches can be approved in the normal manner.

## Path parameters

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

## Request body

- object
  - `icanFrom` integer — The Fire account ID for the fire.com account the funds are taken from.
  - `payeeId` integer — The ID of the existing payee
  - `amount` integer — The value of the payment in the beneficiary currency. Note the last two digits represent pennies/cents, (e.g., £1.00 = 100).
  - `myRef` string — The reference on the transaction for your records - not shown to the beneficiary.
  - `yourRef` string — The reference on the transaction - displayed on the beneficiary bank statement.
  - `paymentReason` string — The reason for the payment, used for transaction monitoring purposes. Must be one of Invoice Payment|Salary/Dividend Payment|Expenses|Savings|Other

## Response `200`

Batch payment added successfully. **Note*** Please use batchUuid when submitting a batch, not batchItemUuid.

- NewBatchItemResponse
  - `batchItemUuid` string — A Batch Item UUID for this item. Note* Do not confuse this for BatchUuid when submitting a batch.

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