---
title: "List disbursements"
method: GET
path: "/accounting-api/disbursements"
tags: ["Accounting (only available for accounting add-on users)"]
---

# List disbursements

`GET /accounting-api/disbursements`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/accounting-api/disbursements`
- Auth: API key in header `authorization`

Returns account-scoped disbursements with filtering, sorting, and offset pagination. Mirrors the Disbursements report columns. Monetary amount / line-item breakdown is intentionally out of scope for this resource — use journal entries filtered by `triggers=DISBURSEMENT` when you need amounts. `accountNumber` is masked to its last four digits; `bankNumber` (routing / bank identifier) is returned in full.

## Query parameters

- `limit` number
- `skip` number
- `payoutDateFrom` string
- `payoutDateTo` string
- `createdAtFrom` string
- `createdAtTo` string
- `payoutStatus` string[]
- `payoutMethod` string[]
- `entityName` string
- `referenceNumber` string
- `sort` 'payoutDate' | '-payoutDate' | 'createdAt' | '-createdAt' | 'payoutStatus' | '-payoutStatus' | 'checkNumber' | '-checkNumber'

## Response `200`

Paginated disbursement list

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `payoutDate` string, date, required
    - `createdAt` string, date-time, required
    - `entityName` string, required
    - `cashAccount` string, required
    - `checkNumber` string, nullable, required
    - `payoutMethod` 'Check' | 'ECheck' | 'Cash' | 'BankTransfer' | 'SEAMLESSCHEX' | 'NACHA' | 'ABA' | 'PrintCheck' | 'ACH', required
    - `payoutStatus` 'CREATED' | 'CANCELED' | 'CANCELLING' | 'RECEIVED' | 'PROCESSING' | 'FAILED' | 'INSUFFICIENT_FUNDS' | 'INVALID' | 'VOID_FAILED' | 'READY_TO_PRINT' | 'CHECK_PRINTED' | 'ON_HOLD', required
    - `referenceNumber` string, nullable, required
    - `accountNumber` string, nullable, required: Bank account number masked to the last four digits (e.g. `****6789`)
    - `bankNumber` string, nullable, required: Bank routing / bank identifier. Returned in full — not subject to the account-number masking policy.
  - `count` number, required
  - `limit` number, required
  - `skip` number, required

## Other responses

- `400`: Invalid query parameter. Common causes: malformed dates (`payoutDateFrom`/`payoutDateTo`/`createdAtFrom`/`createdAtTo` must be ISO-8601), invalid `payoutStatus`/`payoutMethod`/`sort`, or out-of-range `limit`/`skip`.
- `401`: Missing or invalid Bearer access token
- `403`: Authenticated account is not permitted to access this resource (e.g. Accounting feature flow disabled)
- `500`: Unhandled exception. Something went wrong on server

## Changes

- **2026-11-03** `3122b8618183`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/accounting-api/disbursements/get.md)

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)