---
title: "Update an accounts receivable ledger"
method: PATCH
path: "/accounting/v1.0/accounts-receivable-ledgers"
tags: ["Accounts Receivable Ledger"]
---

# Update an accounts receivable ledger

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

Update an existing accounts receivable (AR) ledger. You can change the name, description, linked profile, or status. Only include the fields you want to update. To close a ledger, set the status to CLOSED; note that a ledger can only be closed when its balance is zero.

## Headers

- `X-Property-ID` integer, required

## Request body

- AccountsReceivableLedgerPatchRequest
  - `id` integer, required
  - `name` string
  - `description` string
  - `profileId` integer — Linkage with Profile ID
  - `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.

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

---

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