# Transfer funds between your accounts

Transfer funds between your accounts.

Endpoint: POST /accounts/transfer
Version: 2025-01-01
Security: BasicAuth

## Header parameters:

  - `WP-Api-Version` (string, required)
    Represents the version of the API.
    Example: "2025-01-01"

  - `WP-CorrelationId` (string)
    Optional ID to trace requests, if not provided, it is generated.
    Example: "15cd16b2-7b82-41cb-9b11-21be9dacad88"

  - `WP-CallerId` (string)
    An ID used for logging purposes.

  - `Accept` (string)
    Example: "application/json"

## Request fields (application/json):

  - `sourceAccountNumber` (string, required)
    The source account number.
    Example: "1111550000000001"

  - `targetAccountNumber` (string, required)
    The target account number.
    Example: "1111550000000002"

  - `amount` (number, required)
    The amount. A maximum of seven digits before the decimal place. A maximum of two decimal places.
    Example: "77.22"

  - `narrative` (string, required)
    You can use this to describe what the transfer is for.
    Example: "A narrative"

  - `quoteId` (string,null)
    The quoteId returned by the [FX API](/products/fx/create-fxquote).
    Example: "QuoteId"

## Response 400 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

  - `validationErrors` (array,null)

  - `validationErrors.errorName` (string,null)

  - `validationErrors.message` (string,null)

  - `validationErrors.jsonPath` (string,null)

## Response 401 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

## Response 403 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

## Response 404 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

## Response 500 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)