Transfer funds from one account to another account. No currency conversion is performed, so the sending and receiving accounts must hold money in the same currency.

The API responses shown below are static. If you want to try out the API please login, or register for an API key

API parameters

X-Auth-Token header string Authentication token.
source_account_id formData string Account UUID of the paying account.
destination_account_id formData string Account UUID of the receiving account.
currency formData string Three-digit currency code.
amount formData string Amount.
reason formData string User-generated reason for transfer. Freeform text.
unique_request_id formData string User-generated idempotency key.
curl -X POST  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/transfers/create


    "id": "b232b298-c654-4d06-a544-904fb63c1162",
    "short_reference": "BT-20220131-YZDJDJ",
    "source_account_id": "cf28b2d8-5afa-4d7f-9a26-7b45bf616a11",
    "destination_account_id": "22ed17b5-b90c-424e-aa78-d24928b1778e",
    "currency": "GBP",
    "amount": "100.00",
    "status": "pending",
    "reason": null,
    "created_at": "2022-01-31T14:31:04+00:00",
    "updated_at": "2022-01-31T14:31:04+00:00",
    "completed_at": null,
    "creator_account_id": "72970a7c-7921-431c-b95f-3438724ba16f",
    "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
    "unique_request_id": null
Error Codes
HTTP Status Code Description Params
400 duplicate_unique_request_id The unique_request_id provided for this transfer has already been used, please provide a new one to successfully submit this transfer
401 invalid_supplied_credentials Authentication failed with the supplied credentials
429 too_many_requests Too many requests have been made to the api. Please refer to the Developer Center for more information
500 internal_server_error Internal server error
503 service_unavailable Service is temporary unavailable
Was this post helpful?
Let us know if you liked the post. That’s the only way we can improve.