---
title: "Create Treasury Transfer"
method: POST
path: "/accounts/{account_id}/treasury_transfers"
tags: ["Treasury Mandates"]
---

# Create Treasury Transfer

`POST /accounts/{account_id}/treasury_transfers`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/treasury_transfers`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/treasury_transfers/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- CreateTreasuryTransferRequest
  - `treasury_mandate` string, required: A treasury mandate identifier. This field indicates which treasury mandate will be used to perform the transaction.
  - `type` 'deposit' | 'withdrawal', required: A category describing the a treasury transfer direction: <ul> <li><code>deposit</code> <li><code>withdrawal</code> </ul>
  - `amount` string, number, required: The amount of money to transfer.
  - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for the `amount` listed here. The only currently available currency is `"EUR"`.

## Response `201`

Successful Response

- TreasuryTransferResponse
  - `id` string, required: The unique identifier for this treasury transfer.
  - `treasury_mandate` string, required: A treasury mandate identifier. This field indicates which treasury mandate will be used to perform the transaction.
  - `order` string, required: A treasury mandate identifier. This field indicates the underlying order used to perform the transaction.
  - `type` 'deposit' | 'withdrawal', required: A category describing the a treasury transfer direction: <ul> <li><code>deposit</code> <li><code>withdrawal</code> </ul>
  - `amount` string, required: The amount of money to transfer.
  - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for the `amount` listed here. The only currently available currency is `"EUR"`.
  - `history` StatusChangeTreasuryTransferStatus[], required
    - `status` 'canceled' | 'created' | 'pending' | 'processed' | 'rejected' | 'settled', required: A category describing the a treasury transfer status: <ul> <li><code>canceled</code>: The treasury transfer is canceled. <li><code>created</code>: The treasury transfer is created and waiting for confirmation. <li><code>pending</code>: The treasury transfer is pending execution and waiting to be processed. <li><code>processed</code>: The treasury transfer is processed and waiting to be settled. <li><code>rejected</code>: The treasury transfer is rejected. <li><code>settled</code>: The treasury transfer is settled. </ul>
    - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the treasury transfer was updated.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)