CLcloudbeds
Folios

Move transactions between folios

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.

post/accounting/v1.0/folios/transactions/move

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/accounting/v1.0/folios/transactions/move
  • Auth
    • HTTP bearer
    • or OAuth 2
      Implicit: https://hotels.cloudbeds.com/api/v1.2/oauth
      Scopes: write:payment

Headers

X-Property-IDinteger required

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

Request body

sourceKind'RESERVATION' | 'HOUSE_ACCOUNT' | 'GROUP_PROFILE' | 'ACCOUNTS_RECEIVABLE_LEDGER' 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.

sourceIdinteger required

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

targetFolioIdinteger required

Target folio ID where transactions will be moved

sourceFolioIdinteger

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.

transactionsinteger[]

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

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.