GUguesty
Accounting (only available for accounting add-on users)

List disbursements

Changed on

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.

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

Query parameters

limitnumber

Number of disbursements to return (1-100)

skipnumber

Number of disbursements to skip

payoutDateFromstring
Example:2026-07-01

Inclusive payout date lower bound

payoutDateTostring
Example:2026-07-31

Inclusive payout date upper bound

createdAtFromstring
Example:2026-07-01T00:00:00.000Z

Inclusive creation timestamp lower bound

createdAtTostring
Example:2026-07-31T23:59:59.999Z

Inclusive creation timestamp upper bound

payoutStatusstring[]

Repeat the parameter or provide comma-separated values

payoutMethodstring[]

Repeat the parameter or provide comma-separated values

entityNamestring

Case-insensitive entity name contains filter

referenceNumberstring

Exact reference number filter

sort'payoutDate' | '-payoutDate' | 'createdAt' | '-createdAt' | 'payoutStatus' | '-payoutStatus' | 'checkNumber' | '-checkNumber'

Prefix the field with - for descending order

Response

Paginated disbursement list

countnumber required
limitnumber required
skipnumber required

Example response

{
  "data": [
    {
      "payoutDate": "2026-07-15",
      "createdAt": "2026-07-14T09:32:11.000Z",
      "entityName": "John Smith",
      "cashAccount": "Chase Operating",
      "checkNumber": "1042",
      "payoutMethod": "PrintCheck",
      "payoutStatus": "CHECK_PRINTED",
      "referenceNumber": "REF-99182",
      "accountNumber": "****6789",
      "bankNumber": "021000021"
    }
  ],
  "count": 137,
  "limit": 25
}

Changes