These are the latest Financial endpoint developments you can now benefit from:

Add a Reservation Reference to the Payment Method

Endpoint

• /business-models-api/light-business-models
• /business-models-api/assignment/{businessModelId}
• /guests/{id}/payment-methods

Easily track which guest payment method was used for a reservation by adding the reservation ID to the guest's payment method. This field is optional for now, but will become a requirement from April.

Channel Commissions

Endpoints

• /channel-commission/account
• /channel-commission/listings

You can now define booking channel commissions and taxes on these commissions via our Open API. Specifically, you can update the commissions on an account and listing level. Likewise you can retrieve them too.

To view a list of booking channels and their supported configurations, see this table of enumerators.

Business Models

Endpoints

Our accounting customers can now view their business models via the Open API and assign listings to them.

We’re continuously enhancing our Open API capabilities to seamlessly and securely extend the reach of the Guesty platform across your internal activities. These are the latest significant Open API developments you can now benefit from:

1. New Additional Fee Settings via API

Easily track your invoices and provide transparency to your guests by defining your Additional Fee Settings via our new API.

2. New Tax Settings API

Define more comprehensive Tax Settings and Tax Conditions while ensuring a stable and clear environment, all via unique API endpoints.

3. New API for Detailed Guest Data Collection

Know your guests better and offer them extraordinary, personalized guest experiences, using a new detailed API, including rich guest data fields.

4. New API for Retrieving a Filtered Tasks List

Retrieve any specific set of tasks to support your operations via our upgraded API with enhanced filtering support.

5. New Accounting APIs (only available for Accounting Add-On users)

Ensure financial accuracy by accessing new APIs for Accounting Journal entries and folio balances.

❗

Important

• To enjoy all these new fields and capabilities, remember to switch to the upgraded API before October 31 2022.
• If you haven’t migrated to the Open Authorization 2.0, please make sure you complete the upgrade process and tests before October 31 2022. Learn more about the new Authentication flow here.
• To ensure success and stability of your API calls please allocate time and development resources to complete upgrade processes before the effective dates. After these dates, Guesty will fade out the existing versions and you might experience failed API calls.

While the same webhooks from our old API are still available to you in the new Open API, they're now accompanied by new guides explaining what you can expect from their payloads, and when. Here are the guides currently available with more on the way.

• Webhooks: Reservations
• Webhooks: Failed Payments
• Webhooks: Tasks
• Webhooks: Guests

You asked for it and now you have it. Edit your additional fees and taxes on both the account and listing level via our new Additional Fees and Taxes APIs.

The Listing's Calendar endpoints will no longer be served in Guesty Open API.

Retrieving a single calendar
GET /listings/:id/calendar

Retrieving multiple calendars
GET /listings/calendars

Update calendars
PUT /listings/calendars

📘

Tip:

Instead of Listing's Calendar endpoints, you can use the Calendar endpoints.

The Search endpoint will no longer be served in Guesty Open API.

Search for everything
GET /search

📘

Tip:

Instead of the Search endpoint, you can use the relevant dedicated endpoint with specific fields and filters to retrieve the data required.

For instance; you can use GET /reservations endpoint for reservations, GET /listings endpoint for listings, and so on. Please see our API reference for the list of available endpoints.