Creating account transfer

Creating account address

POST /api/public/v1/transfers

This endpoint creates a transfer between accounts in the same currency. You can transfer funds between a master account and a subaccount, or between subaccounts.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_key>

Body

Name	Type	Description
data	object	Object with exchange request data.
data.type	string	Exchange request type. Always transfers.
data.attributes	object	A set of exchange request attributes.
data.attributes.from_account	string	From account ID.
data.attributes.to_account	string	To account ID.
data.attributes.amount	number	Transfer amount.
data.attributes.currency	string	Transfer currency.
data.attributes.reference	string	Unique reference ID for this transfer, included in downloadable CSV transaction reports.

Request JSON

{
  "data": {
    "type": "tranfers",
    "attributes": {
      "from_account": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "to_account": "dd5016e1-43bb-4be5-b6d6-79e8d0f662b1",
      "amount": 10,
      "currency": "EUR",
      "reference": "c9807056-88da-409e-b628-732adbe76be5"
    }
  }
}

Response

HTTP 200

{
  "data": {
    "id": "5cdf75bf-7f9e-410f-a4a4-841667f57c9f",
    "type": "accountTransfers",
    "attributes": {
      "reference": "1b313a1f-306e-4299-bd61-67f60c851267"
    },
    "relationships": {
      "accountTransactions": {
        "data": [
          {
            "type": "accountTransactions",
            "id": "e55508e2-81b3-4e0f-b49c-380abc9dec91"
          },
          {
            "type": "accountTransactions",
            "id": "179a4edb-0af4-405d-a006-a8588140bb85"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "e55508e2-81b3-4e0f-b49c-380abc9dec91",
      "type": "accountTransactions",
      "attributes": {
        "createdAt": "2026-01-09T10:38:24.351Z",
        "amount": "-10.00"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "accounts",
            "id": "13a85b45-8543-41c7-b963-394d4ea128ae"
          }
        },
        "accountTransfer": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "179a4edb-0af4-405d-a006-a8588140bb85",
      "type": "accountTransactions",
      "attributes": {
        "createdAt": "2026-01-09T10:38:24.395Z",
        "amount": "10.00"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "accounts",
            "id": "dd5016e1-43bb-4be5-b6d6-79e8d0f662b1"
          }
        },
        "accountTransfer": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "EUR",
        "label": "master",
        "bankReference": "BDR6421088115176062",
        "balance": "38465.76",
        "totalBalance": "38687.80",
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "dd5016e1-43bb-4be5-b6d6-79e8d0f662b1",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "EUR",
        "label": "EUR_1",
        "bankReference": "BDR4778763138567183",
        "balance": "90.54",
        "totalBalance": "90.54",
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}

HTTP 422

HTTP 404