---
title: "List accounts receivable ledgers"
method: GET
path: "/accounting/v1.0/accounts-receivable-ledgers"
tags: ["Accounts Receivable Ledger"]
---

# List accounts receivable ledgers

`GET /accounting/v1.0/accounts-receivable-ledgers`

Retrieve a paginated list of accounts receivable (AR) ledgers for a property. You can filter by status, date range, balance range, profile, and search query. Use AR ledgers to track balances that have been transferred from reservations or group profiles for later collection.

## Query parameters

- `filter` object
  - `searchQuery` string
  - `createdDateTimeFrom` string, date-time
  - `createdDateTimeTo` string, date-time
  - `balanceFrom` integer
  - `balanceTo` integer
  - `totalFrom` integer
  - `totalTo` integer
  - `paidFrom` integer
  - `paidTo` integer
  - `profileId` integer
  - `status` AccountsReceivableLedgerStatus[]
  - `sortBy` 'status' | 'name' | 'created_at' | 'balance' | 'paid' | 'total' — Sort field
  - `sortDirection` 'asc' | 'desc' — Direction for sort - asc or desc
  - `pageToken` string
  - `pageSize` integer

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- AccountsReceivableLedgerPaginated
  - `content` AccountsReceivableLedgerResponse[]
    - `id` string
    - `name` string
    - `description` string
    - `status` 'OPEN' | 'CLOSED' — Status of an accounts receivable ledger. OPEN ledgers can receive balance transfers and payments. CLOSED ledgers are settled and no longer accept new transactions.
    - `propertyId` string
    - `profileId` string, int64 — Profile ID associated with this accounts receivable ledger
    - `total` number — Total amount of all charges transferred to this AR ledger, in the smallest currency unit.
    - `paid` number — Total amount of payments applied to this AR ledger, in the smallest currency unit.
    - `balance` number — Outstanding balance (total minus paid), in the smallest currency unit.
    - `createdAt` string — Created datetime (ISO 8601) in UTC
    - `updatedAt` string — Updated datetime (ISO 8601) in UTC
  - `nextPageToken` string — Token for fetching the next page of results

## 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/versions/2faa857793e8/schema)