---
title: "List transactions for an AR ledger"
method: GET
path: "/accounting/v1.0/accounts-receivable-ledgers/{accountsReceivableLedgerId}/transactions"
tags: ["Accounts Receivable Ledger"]
---

# List transactions for an AR ledger

`GET /accounting/v1.0/accounts-receivable-ledgers/{accountsReceivableLedgerId}/transactions`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/accounting/v1.0/accounts-receivable-ledgers/{accountsReceivableLedgerId}/transactions`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Implicit: `https://hotels.cloudbeds.com/api/v1.2/oauth`
    - Scopes: `read:payment`

Retrieve a paginated list of transactions belonging to a specific accounts receivable (AR) ledger. You can filter by transaction state (posted or pending), date ranges, transaction type, and more. Use this endpoint to review the detailed financial activity within an AR ledger.

## Path parameters

- `accountsReceivableLedgerId` integer, required

## Query parameters

- `pageToken` string
- `pageSize` integer
- `filter` object
  - `transactionStates` TransactionState[]: transaction states
  - `searchQuery` string
  - `transactionDateFrom` string, date
  - `transactionDateTo` string, date
  - `checkinDateFrom` string, date
  - `checkinDateTo` string, date
  - `checkoutDateFrom` string, date
  - `checkoutDateTo` string, date
  - `transactionType` string[]
  - `userId` integer[]
  - `sortBy` 'CHECKOUT_DATE' | 'CHECKIN_DATE' | 'TRANSACTION_DATE' | 'AMOUNT': Sort field
  - `sortDirection` 'asc' | 'desc': Direction for sort - asc or desc

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- AccountsReceivableTransactionPaginated
  - `content` AccountsReceivableTransactionResponse[]
    - `id` string: Id of the transaction.
    - `transactionDate` string, date-time: Date time of the transaction.
    - `amount` number: amount of the transaction.
    - `internalTransactionCode` string: Internal Transaction Code
    - `description` string: Description
    - `notes` string: Notes
    - `currency` string: Currency ISO code
    - `currencyScale` integer: Number of decimal places for the currency.
    - `posted` boolean: Flag to mark if transaction is posted
    - `user` UserModel
      - `id` string: The ID of the user.
      - `firstName` string: The name of the user.
      - `lastName` string: The last name of the user.
      - `email` string: User email
      - `type` 'REAL_USER' | 'SYSTEM_USER' | 'UNKNOWN_USER': REAL_USER - user was found, UNKNOWN_USER - user was not found, SYSTEM_USER - user_id = 0 OR null
    - `actions` Action[]: Returns the list of actions available for the transaction
      - `type` string: Type of Action
      - `parameters` object: Parameters required for the action, can be any object.
    - `transferDetails` object: Reservation or Group Profile details for which the transfer was made.
      - `reservation` ReservationTransferDetails
        - `id` string: Reservation ID.
        - `identifier` string: Reservation Identifier.
        - `guestName` string: Guest Name.
        - `status` 'checked_out' | 'checked_in' | 'confirmed' | 'canceled' | 'not_confirmed' | 'inquiry' | 'deleted' | 'no_show': Current status of a reservation. The status affects which accounting operations are permitted (e.g., charges cannot be added to a checked-out reservation).
        - `checkinDate` string, date: Check in date.
        - `checkoutDate` string, date: Checkout in date.
      - `groupProfile` GroupProfileTransferDetails
        - `id` string: Group Profile ID.
        - `name` string: Group Profile Name.
        - `code` string: Group Profile Code.
  - `nextPageToken` string: Token for fetching the next page of results

## 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)