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

# Get AR ledger totals

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

## Request

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

Retrieve aggregated totals across all accounts receivable (AR) ledgers for a property. The response includes the combined total charges, amount paid, and outstanding balance. You can optionally filter by ledger status to see totals for only open or closed ledgers.

## Query parameters

- `filter` object
  - `status` AccountsReceivableLedgerStatus[]

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- AccountsReceivableLedgerTotalsResponse: Aggregated totals across all matching accounts receivable ledgers.
  - `total` number: Sum of all charges across matching AR ledgers, in the smallest currency unit.
  - `paid` number: Sum of all payments across matching AR ledgers, in the smallest currency unit.
  - `balance` number: Sum of outstanding balances across matching AR ledgers (total minus paid), in the smallest currency unit.

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