Sign in

v1

latestOpenAPI 3.0.12026-07-245277551.2 MB
SourceBalance

Get source balance

Retrieve the financial balance summary for a specific source. The source can be a reservation, house account, group profile, or accounts receivable ledger, identified by the sourceKind and sourceId path parameters. The response includes a detailed breakdown of charges (subtotal, additional items, taxes, fees), payments, refunds, upcoming payments, and the overall balance due. Use the optional Accept-Language header to receive localized tax and fee names.

get/accounting/v1.0/source-balances/{sourceKind}/{sourceId}

Path parameters

sourceKind'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER' required

Kind of the source entity

The type of source entity. Determines how the sourceId is interpreted.

sourceIdinteger required

Unique identifier of the source entity. The meaning depends on the sourceKind parameter: a reservation ID, house account ID, group profile ID, or accounts receivable ledger ID.

Headers

X-Property-IDinteger required

Property id

Accept-Languagestring

Desired language of exported PDF

Response

OK

currencystring

Currency code (e.g., USD)

currencyScaleinteger

Number of decimal places for the currency

grandTotalnumber double

Grand total amount in smallest currency unit

subtotalnumber double

Subtotal amount in smallest currency unit

additionalItemsnumber double

Additional items amount in smallest currency unit

arTransfernumber double

Accounts receivable transfer amount in smallest currency unit

amountPaidnumber double

Amount paid in smallest currency unit

refundIssuednumber double

Refund issued amount in smallest currency unit

upcomingPaymentsnumber double

Upcoming payments amount in smallest currency unit

upcomingRefundnumber double

Upcoming refund amount in smallest currency unit

cancellationFeenumber double

Cancellation fee amount in smallest currency unit

noShowFeenumber double

No show fee amount in smallest currency unit

balanceDuenumber double

Balance due amount in smallest currency unit

channelCommissionnumber double

Channel commission amount in smallest currency unit

gratuitynumber double

Gratuity (TIP) total in smallest currency unit (ITC 8995 family).

updatedAtstring date-time

Timestamp when the balance was last updated (UTC)