**Last updated**: 14 May 2025 | [**Change log**](/products/transfers/changelog/)

# Account Transfers API

Transfer funds between your currency accounts.

Important
Make yourself familiar with our [API Principles](/products/reference/api-principles) to ensure a resilient integration.

## Get started

Ready to integrate? Use our [API Reference](/products/transfers/v1/openapi) and set your headers.

## Request

`POST`  `https://try.access.worldpay-bsh.securedataplatform.com/accounts/transfer/`

### Request schema:


```json
{
  "$ref": "#/components/schemas/TransferRequest",
  "components": {
    "schemas": {
      "TransferRequest": {
        "type": "object",
        "properties": {
          "sourceAccountNumber": {
            "type": "string",
            "nullable": false,
            "description": "The 16-digit transfer source account number."
          },
          "targetAccountNumber": {
            "type": "string",
            "nullable": false,
            "description": "A 16-digit transfer destination account number."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "A decimal value for the transfer. Currency is defined by the source account currency."
          },
          "narrative": {
            "type": "string",
            "nullable": false,
            "description": "A description about the transfer."
          },
          "quoteId": {
            "type": "string",
            "nullable": false,
            "description": "The ID of the quote of an exchange rate for the transfer. Not currently used - can set as empty guid value (all zeros)."
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Example request


```json
{
"sourceAccountNumber":"1111550000000001",
"targetAccountNumber":"1111550000000002",
"amount":123.45,
"narrative":"CurrencyTransfer12",
"quoteID":"Q0000000BV"
}
```

br
## Response

### Response examples

Successful response
**Body of the response**

There is **no body** for a successful response. Only HTTP status **202** will be returned.

Error response

```json
{
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Source account number must be 16 characters",
      "jsonPath": "$.SourceAccountNumber"
    }
  ],
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema"
}
```

#### Errors

Check out our API reference for the full [error code schema](/products/transfers/openapi).