API Reference

Availability

post
https://thehotelplanet.com/cm/v2/engine/v1/availability

Check real-time hotel room and rate availability for one or more properties. This endpoint allows you to search for available rooms, rates, and pricing based on property IDs, dates, occupancies, currency, agency, nationality, and optional coupon codes. Returns a list of available properties, rates, and reasons for unavailability if applicable.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request structure for searching hotel room and rate availability.

property_ids
array of integers
required

List of HotelPlanet property (hotel) IDs to search availability for.

property_ids*
date
required

Check-in date (YYYY-MM-DD).

date
required

Check-out date (YYYY-MM-DD).

occupancies
array of objects
required
occupancies*
string

Requested currency code (e.g., USD, EUR). If no currency is provided, results will be defaulted to the hotel's local currency.

string

Agency or client identifier.

string

Nationality code of the guest (e.g., US, JP).

Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?