Move transactions between folios

post

https://api.cloudbeds.com/accounting/v1.0/folios/transactions/move

Move transactions to a different folio within the same source. You can specify individual transaction IDs or transaction types (by origin ID and external relation kind) to move all matching transactions at once. At least one of transactions or transactionTypes must be provided.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request to move transactions to a target folio. At least one of transactions or transactionTypes must be provided and non-empty. When sourceFolioId is provided, only transactions currently in that folio are affected.

sourceKind

string

enum

required

The type of financial source that owns transactions and balances. RESERVATION is an individual guest booking, HOUSE_ACCOUNT is a property-level account for miscellaneous charges, GROUP_PROFILE is a group booking that can aggregate charges from multiple reservations, and ACCOUNTS_RECEIVABLE_LEDGER tracks balances transferred for later collection.

Allowed:

sourceId

int64

required

Source ID (reservation ID, group profile ID, etc.)

targetFolioId

int64

required

Target folio ID where transactions will be moved

sourceFolioId

int64

Optional. Scopes the operation to the transactions the folio list endpoint returns for this folio (deposit-account transactions are excluded; pending transactions count in their routed-to folio; applies to both transactions and transactionTypes selection). The folio must belong to the request's source (for route: to the reservation). When omitted, transactions are matched across all folios of the source.

transactions

array of int64s

length ≥ 1

List of transaction IDs to move. Required if transactionTypes is not provided.

transactions

transactionTypes

array of objects

length ≥ 1

List of transaction types to move (by origin ID and external relation kind). Required if transactions is not provided.

transactionTypes

Headers

X-Property-ID

int64

required

Unique identifier of the property. Required for all requests to scope data to a specific property.

Responses

200

400Bad Request

404Not found