---
title: "Get an accounts receivable ledger by ID"
method: GET
path: "/accounting/v1.0/accounts-receivable-ledgers/{accountsReceivableLedgerId}"
tags: ["Accounts Receivable Ledger"]
---

# Get an accounts receivable ledger by ID

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

## Request

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

Retrieve a single accounts receivable (AR) ledger by its unique identifier. The response includes the ledger name, status, total charges, amount paid, and outstanding balance.

## Path parameters

- `accountsReceivableLedgerId` integer, required

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- 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

## Other responses

- `400`: Bad Request
- `404`: Not found

---

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