2026-11-19

Covers changes published between 6 and 18 November 2026; nothing in this release is breaking.

Changed

  • Update the Reservation migration guide: legacy guest payment resources now retire on 1 March 2027, the same date as the legacy reservation endpoints (previously no removal date); GET /reservations-v3/search supports incremental sync through filter[lastUpdatedAt] (previously "not supported"); POST /reservations.csv names GET /reservations-reports/{viewId}/csv as its first replacement; add "Who is this for?" and "Known constraints" sections
  • Rename the Accounting (only available for accounting add-on users) group to [Add-on] Accounting (the /accounting-api/* and /business-models-api/* operations in it) and Expenses (only available for accounting add-on users) to [Add-on] Expenses (the /expenses-api/expenses* operations)
  • Add the paid add-on notice to the description of the 8 /accounting-api/*, 6 /expenses-api/expenses* and 7 /business-models-api/* operations in the two add-on groups; for GET /expenses-api/expenses, GET /expenses-api/expenses/{id}, POST /expenses-api/expenses/{id}/cancel, DELETE /expenses-api/expenses/{id}/attachments/{attachmentId} and PUT /business-models-api/assignment/{businessModelId} this is the only change
  • Describe each field of the error responses of the 8 /accounting-api/* operations, POST /expenses-api/expenses and POST /expenses-api/expenses/{id}/attachments
  • Rewrite GET /accounting-api/reservations/{reservationId}/balance description, describe its response fields, document a 400 for a listing whose business model isn't active, and rename the path parameter from {id} to {reservationId} (it's a placeholder)
  • Rename the path parameter from {id} on GET /accounting-api/owners/{ownerId}/working-capital and PUT /accounting-api/owners/{ownerId}/working-capital to {ownerId}, rewrite the GET description, and state that PUT replaces the current value, is idempotent, and can return a documented 404
  • Rename the path parameter from {id} on GET /accounting-api/disbursements/{disbursementId} to {disbursementsId}, change its summary to "Get disbursement by ID", and describe its response fields
  • Document accepted payoutStatus and payoutMethod values, add format to the date parameters, and describe response fields on GET /accounting-api/disbursements
  • Rename GET /accounting-api/journal-entries to "Search recognized journal entries", rewrite its description, add @gt, @gte and @lte to the transactionDate operators, and state the skip, limit and sortByDate defaults
  • Rename GET /accounting-api/journal-entries/all to "Search all journal entries", apply the same documentation updates as GET /accounting-api/journal-entries, document that recognized accepts true or false (case-insensitive), and add a required category field to response items
  • Rename GET /accounting-api/categories to "List categories", rewrite its description (predefined and user-created categories, sorted A to Z), and describe its response fields
  • Document the PDF and image rules for attachments on POST /expenses-api/expenses (required url, urlThumbnail, extension, and fileName; accepted extensions listed), change the fileName example to invoice-copy.png, and note that PDFs added through the Open API can't be previewed in the Guesty dashboard
  • Apply the same attachment documentation, plus the "up to 10 attachments" wording, to POST /expenses-api/expenses/{id}/attachments
  • Describe listingsCount (current and scheduled future assignments, never capped) on GET /business-models-api/light-business-models and reword its assignedListings descriptions
  • Describe listingsCount and the 400 body fields on PATCH /business-models-api/light-business-models/{id}
  • Document that vatOCConfig.categoryId takes precedence over categoryCode on POST /business-models-api/transactions/owner-charges and POST /business-models-api/transactions/owner-charges-by-listing
  • Rewrite POST /business-models-api/transactions/expenses-by-listing description: the listing comes from expenseShare.listingId, omitting expenseShare records the expense on the PMC alone, and shareSplit of 0 keeps the full amount on the PMC while attaching the listing

Added

  • Add GET /expenses-api/expense-rules endpoint to list recurring expense rules, filterable by status, listingId, categoryId, vendorId, and name; returns only active and draft rules by default
  • Add POST /expenses-api/expense-rules endpoint to create a recurring expense rule (draft or active) and assign it to listings; assignment is asynchronous, so GET /expenses-api/expense-rules/{id} reflects the listings once processed
  • Add GET /expenses-api/expense-rules/{id} endpoint to retrieve a recurring expense rule, including its chargeable, share, vendor, channels, and tax groups and its listingIds
  • Add bulk lookup (filter[reservationId] and filter[reservationId][in], up to 100 IDs), incremental sync (filter[lastUpdatedAt][gte], filter[lastUpdatedAt][lt] and sort=lastUpdatedAt) and a lastUpdatedAt result field to GET /reservations-v3/search, and document the new 400 cases
  • Document the reservation.payments.updated webhook in the Payment webhooks guide: when it is sent (including when only totalPaymentFees changes) and its payload
  • Document in the Financial webhooks guide that the guest-folio.updated payload has no totalPaymentFees and that fee changes may not trigger it; subscribe to reservation.payments.updated instead

Fixed

  • Correct the 403 ("Accounting feature flow disabled", previously "You do not have sufficient permissions to access this resource") and 404 ("Can't find the reservation or its listing's business model", previously "Can't find reservation, by provided ID") of GET /accounting-api/reservations/{reservationId}/balance
  • Correct GET /accounting-api/owners/{ownerId}/working-capital 404 to "Owner was not found." (previously "Can't find owner, by provided ID") and document workingCapital as required on PUT /accounting-api/owners/{ownerId}/working-capital (previously optional)
  • Type skip and limit as integer (previously number) on GET /accounting-api/disbursements, GET /accounting-api/journal-entries, GET /accounting-api/journal-entries/all and GET /accounting-api/categories
  • Correct GET /accounting-api/journal-entries and GET /accounting-api/journal-entries/all: limit minimum is 1 (previously 0), ledger adds POA and DO (both deprecated), triggers adds COMMISSION_ADJUSTMENT, OPENAPI, EXPENSES_CSV_IMPORT and BULK_UPLOADS, date has format: date, and the guest, vendor, owner, listing, and charge-code response fields are nullable
  • Remove assignedListings and assignedListingsTruncated from the 200 response of PATCH /business-models-api/light-business-models/{id} (previously shown, though the operation has no includeAssignedListings parameter), and correct its 400 data example to ["Category must not exceed 255 characters"] (previously the listingIds messages from the assignment endpoint)
  • Correct the 404 of POST /business-models-api/transactions/owner-charges, POST /business-models-api/transactions/owner-charges-by-listing, POST /business-models-api/transactions/expenses and POST /business-models-api/transactions/expenses-by-listing to name the owner, listing, or vendor not found in a required data string (previously only message and status, with the message Can't find business-model with ID {business_model_id})