---
title: "Create transfer request"
method: POST
path: "/v1/accounts/{account_id}/transfer_requests"
tags: ["Transfer requests"]
---

# Create transfer request

`POST /v1/accounts/{account_id}/transfer_requests`

Creates a transfer request and associates it with the account specified in the request URL. This method will create a reservation on the account for the amount specified in the transfer request.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `amount` MoneyWithUnit
    - `value` integer — The amount, in Euro cents.
    - `unit` string — The unit of the amount.
    - `currency` 'EUR' — The currency of the transfer request. Only EUR is supported.
  - `reference` string — A unique reference for the transfer request. Acts as an idempotency key.
  - `description` string — A description for the transfer request.

## Response `201`

Transfer request created successfully

- TransferRequest
  - `id` string — Unique ID of the transfer request.
  - `reservation_id` string — Unique ID of the reservation associated with the transfer request.
  - `amount` MoneyWithUnit
    - `value` integer — The amount, in Euro cents.
    - `unit` string — The unit of the amount.
    - `currency` 'EUR' — The currency of the transfer request. Only EUR is supported.
  - `reference` string — A unique reference for the transfer request. Used as an idempotency key.
  - `description` string — The description of the transfer request.
  - `resolved` boolean — Indicates whether the transfer request was resolved.

## Other responses

- `400` — An error occurred on the client side.
- `403` — Unauthorized action.
- `404` — Account not found
- `500` — Internal server error

---

[API](https://skmtc.net/solarisgroup/apis/transactions.md) · [All operations](https://skmtc.net/solarisgroup/apis/transactions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/transactions/revisions/8df83424e244/schema)