What is the correct base URL and endpoint for fetching bookings/calendar data via the Hosthub API?

To fetch calendar events (bookings, availability) via the Hosthub API, use the following request:

 GET ``https://app.hosthub.com/api/2019-03-01/rentals/{rentalId}/calendar-events 

Authentication is done with an Authorization header set directly to your API key — do not use "Bearer" or any other prefix, just the raw API key. The endpoint https://app.hosthub.com/api/v1/bookings will return a 404 as it is not a valid endpoint. Full API documentation is available at https://www.hosthub.com/docs/api/, where you can also download the YAML file describing all endpoints and attributes.

Retrieving rates, minimum stays, and restrictions for a custom website

A custom website (including sites built with website builders such as Lovable or Hostinger, or fully custom code) can use the Hosthub API to keep Hosthub as the single source of truth for pricing, availability, and booking restrictions. The relevant data maps to the following endpoints:

• Rental ID — List Rentals
• Rate Plan ID and Rate Plan name — List Rate plans
• Daily rate/price per date, Currency, Minimum stay, restrictions, and the dates for which the rate was generated — Get rate plan daily rates (all found in the response of this endpoint)
• Availability / booked dates — Not returned by a dedicated endpoint. It must be derived from List Calendar Events for Rental.

Notes:

• An active channel connection is not required for rate mandates or daily rates to be generated via the API. A default rate plan is created as soon as a rental is created, and stays empty until a rate mandate finishes processing.
• The first rate mandate on a newly created rental can take up to a couple of hours to move from "pending" to "executed." During that window GET /rate-plans/{id}/rates correctly returns an empty array; once executed, it returns the priced days.
• When you change a rate, minimum stay, or check-in/check-out restriction in Hosthub, the website retrieves the updated values by polling these endpoints (there is no webhook/push mechanism).

Updated on: 05/10/2026