---
title: "Transfer deposit transactions"
method: POST
path: "/accounting/v1.0/deposits/transfer"
tags: ["Deposits"]
---

# Transfer deposit transactions

`POST /accounting/v1.0/deposits/transfer`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/accounting/v1.0/deposits/transfer`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Implicit: `https://hotels.cloudbeds.com/api/v1.2/oauth`
    - Scopes: `write:payment`

Transfer one or more deposit transactions to the guest ledger. Provide the transaction IDs of the deposits you want to transfer. This operation is processed asynchronously; the response includes an event ID you can use to track the result.

## Headers

- `X-Property-ID` integer, required

## Request body

- TransferDepositPostRequest
  - `transaction_ids` string[]
  - `amount` number: Partial amount to transfer in decimal form (e.g. 50.00). When provided, transaction_ids must contain exactly one element. When omitted, full amount of each transaction is transferred.

## Response `200`

OK

- AsyncEventResponse
  - `eventId` string: Id of event which will be processed asynchronous.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/cloudbeds/apis/accounting-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/accounting-api/revisions/0b58c698deef?raw)