--- updatedAt: 2026-08-26T14:55:37.000Z agentTools: projectIndex: https://open-api-docs.guesty.com/llms.txt --- # List disbursements 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. # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "GUESTY OPEN API", "description": "Guesty Open API documentation", "version": "1" }, "servers": [ { "url": "https://open-api.guesty.com/v1" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Accounting (only available for accounting add-on users)" } ], "paths": { "/accounting-api/disbursements": { "get": { "operationId": "DisbursementsController_getDisbursements", "summary": "List disbursements", "tags": [ "Accounting (only available for accounting add-on users)" ], "description": "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.", "parameters": [ { "name": "limit", "required": false, "in": "query", "description": "Number of disbursements to return (1-100)", "schema": { "minimum": 1, "maximum": 100, "default": 25, "type": "number" } }, { "name": "skip", "required": false, "in": "query", "description": "Number of disbursements to skip", "schema": { "minimum": 0, "default": 0, "type": "number" } }, { "name": "payoutDateFrom", "required": false, "in": "query", "description": "Inclusive payout date lower bound", "schema": { "example": "2026-07-01", "type": "string" } }, { "name": "payoutDateTo", "required": false, "in": "query", "description": "Inclusive payout date upper bound", "schema": { "example": "2026-07-31", "type": "string" } }, { "name": "createdAtFrom", "required": false, "in": "query", "description": "Inclusive creation timestamp lower bound", "schema": { "example": "2026-07-01T00:00:00.000Z", "type": "string" } }, { "name": "createdAtTo", "required": false, "in": "query", "description": "Inclusive creation timestamp upper bound", "schema": { "example": "2026-07-31T23:59:59.999Z", "type": "string" } }, { "name": "payoutStatus", "required": false, "in": "query", "description": "Repeat the parameter or provide comma-separated values", "schema": { "type": "array", "items": { "type": "string", "enum": [ "CREATED", "CANCELED", "CANCELLING", "RECEIVED", "PROCESSING", "FAILED", "INSUFFICIENT_FUNDS", "INVALID", "VOID_FAILED", "READY_TO_PRINT", "CHECK_PRINTED", "ON_HOLD" ] } } }, { "name": "payoutMethod", "required": false, "in": "query", "description": "Repeat the parameter or provide comma-separated values", "schema": { "type": "array", "items": { "type": "string", "enum": [ "Check", "ECheck", "Cash", "BankTransfer", "SEAMLESSCHEX", "NACHA", "ABA", "PrintCheck", "ACH" ] } } }, { "name": "entityName", "required": false, "in": "query", "description": "Case-insensitive entity name contains filter", "schema": { "maxLength": 255, "type": "string" } }, { "name": "referenceNumber", "required": false, "in": "query", "description": "Exact reference number filter", "schema": { "maxLength": 255, "type": "string" } }, { "name": "sort", "required": false, "in": "query", "description": "Prefix the field with - for descending order", "schema": { "default": "-payoutDate", "enum": [ "payoutDate", "-payoutDate", "createdAt", "-createdAt", "payoutStatus", "-payoutStatus", "checkNumber", "-checkNumber" ], "type": "string" } } ], "responses": { "200": { "description": "Paginated disbursement list", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "payoutDate": { "type": "string", "example": "2026-07-15", "format": "date" }, "createdAt": { "type": "string", "example": "2026-07-14T09:32:11.000Z", "format": "date-time" }, "entityName": { "type": "string", "example": "John Smith" }, "cashAccount": { "type": "string", "example": "Chase Operating" }, "checkNumber": { "type": "string", "nullable": true, "example": "1042" }, "payoutMethod": { "enum": [ "Check", "ECheck", "Cash", "BankTransfer", "SEAMLESSCHEX", "NACHA", "ABA", "PrintCheck", "ACH" ], "type": "string", "example": "PrintCheck" }, "payoutStatus": { "type": "string", "enum": [ "CREATED", "CANCELED", "CANCELLING", "RECEIVED", "PROCESSING", "FAILED", "INSUFFICIENT_FUNDS", "INVALID", "VOID_FAILED", "READY_TO_PRINT", "CHECK_PRINTED", "ON_HOLD" ], "example": "CHECK_PRINTED" }, "referenceNumber": { "type": "string", "nullable": true, "example": "REF-99182" }, "accountNumber": { "type": "string", "nullable": true, "example": "****6789", "description": "Bank account number masked to the last four digits (e.g. `****6789`)" }, "bankNumber": { "type": "string", "nullable": true, "example": "021000021", "description": "Bank routing / bank identifier. Returned in full — not subject to the account-number masking policy." } }, "required": [ "id", "payoutDate", "createdAt", "entityName", "cashAccount", "checkNumber", "payoutMethod", "payoutStatus", "referenceNumber", "accountNumber", "bankNumber" ] } }, "count": { "type": "number", "example": 137 }, "limit": { "type": "number", "example": 25 }, "skip": { "type": "number", "example": 0 } }, "required": [ "data", "count", "limit", "skip" ] } } } }, "400": { "description": "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`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad Request" }, "code": { "type": "string", "example": "VALIDATION_FAILED" }, "status": { "type": "number", "example": 400 }, "data": { "example": [ "payoutDateFrom must be a valid ISO 8601 date string", "each value in payoutStatus must be one of the following values: CREATED, CANCELED, FAILED, INVALID", "limit must not be greater than 100" ], "type": "array", "items": { "type": "string" } } }, "required": [ "message", "code", "status", "data" ] } }, "required": [ "error" ] } } } }, "401": { "description": "Missing or invalid Bearer access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Unauthorized" }, "code": { "type": "string", "example": "UNAUTHORIZED" }, "status": { "type": "number", "example": 401 } }, "required": [ "message", "code", "status" ] } }, "required": [ "error" ] } } } }, "403": { "description": "Authenticated account is not permitted to access this resource (e.g. Accounting feature flow disabled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Missing account_id error message" }, "status": { "type": "number", "example": 403 } }, "required": [ "message", "status" ] } }, "required": [ "error" ] } } } }, "500": { "description": "Unhandled exception. Something went wrong on server", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Something went wrong" }, "status": { "type": "number", "example": 500 } }, "required": [ "message", "status" ] } }, "required": [ "error" ] } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "apiKey", "name": "authorization", "in": "header" } } }, "x-kong-upstream-prefix": "/integrations/brands", "x-kong-route-transformations": [ { "configuration": "v1", "routeExtpath": "/account-brands", "stripPrefix": "/v1/account-brands" } ] } ```