---
title: "List custom transaction codes"
method: GET
path: "/accounting/v1.0/custom-transaction-codes"
tags: ["Custom Transaction Codes"]
---

# List custom transaction codes

`GET /accounting/v1.0/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.

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- CustomTransactionCodesModel[]
  - `id` string
  - `version` integer
  - `name` string, required
  - `code` string, required — The custom code assigned by the user.
  - `transactionItemCode` string — The system code that cannot be modified.
  - `sku` string
  - `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.
  - `customGeneralLedgerCodeId` string
  - `itemId` string — Item ID for items_services group
  - `posItemId` string — POS Item ID for items_services group
  - `taxId` string — Tax ID for taxes_fees group (taxes)
  - `feeId` string — Fee ID for taxes_fees group (fees)
  - `paymentId` string — Payment ID for payments group
  - `spaceId` string — Space ID for spaces group
  - `channelId` string — Channel ID for channel commission group

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)