CLcloudbeds
Custom Transaction Codes

List custom transaction codes

Retrieve all custom transaction code mappings for a property. Custom transaction codes let you assign your own codes to each Cloudbeds internal transaction type (e.g., room rate, tax, payment method). You must call the initialize endpoint before codes can be retrieved for the first time.

get/accounting/v1.0/custom-transaction-codes

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/accounting/v1.0/custom-transaction-codes
  • Auth
    • HTTP bearer
    • or OAuth 2
      Implicit: https://hotels.cloudbeds.com/api/v1.2/oauth
      Scopes: read:payment

Headers

X-Property-IDinteger required

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

Response

OK

idstring
versioninteger
namestring required
codestring required

The custom code assigned by the user.

transactionItemCodestring

The system code that cannot be modified.

skustring
itemGroup'items_services' | 'reservations' | 'taxes_fees' | 'payments' | 'accrual_accounting' | 'custom_item' | 'spaces' | 'accounts_receivable_transfers' | 'deposit_transfers' | 'channel_commission' | 'gratuity'

Category grouping for transaction item codes. Used to classify custom transaction codes and general ledger codes.

  • items_services — Products and services sold to guests (minibar, restaurant, spa, etc.).
  • reservations — Room rate charges and room revenue adjustments.
  • taxes_fees — Tax and fee line items applied to charges.
  • payments — Payment transactions (cash, card, bank transfer, etc.).
  • accrual_accounting — Accrual accounting entries for revenue recognition.
  • custom_item — Custom POS or manually created charge items.
  • spaces — Charges related to bookable spaces (meeting rooms, event venues, etc.).
  • accounts_receivable_transfers — Transfers to or from accounts receivable ledgers.
  • deposit_transfers — Transfers to or from the deposit ledger.
customGeneralLedgerCodeIdstring
itemIdstring

Item ID for items_services group

posItemIdstring

POS Item ID for items_services group

taxIdstring

Tax ID for taxes_fees group (taxes)

feeIdstring

Fee ID for taxes_fees group (fees)

paymentIdstring

Payment ID for payments group

spaceIdstring

Space ID for spaces group

channelIdstring

Channel ID for channel commission group

Changes

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