These endpoints provide comprehensive functionality for managing hotel bookings. They enable users to search for hotels, check room rates and availability, create and modify bookings, and handle cancellations and rebooking.
The parameters required for searching hotels.
Occupancy values and dates for the hotel search.
List of occupancy details including the number of adults and children.
Local date and time represented in the ISO 8601 standard.
Criteria used for searching hotels. The searchType
field can contain one criteria per request.
Filters to refine the search result. Based on the user selected filters, the list of matching hotels will be displayed.
curl -i -X POST \ https://developer.spotnana.com/_mock/openapi/hotelapi/v2/hotel/search \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "searchParams": { "occupancyDates": { "occupancy": [ { "numAdults": 1, "numChildren": 0 } ], "checkInDate": { "iso8601": "2017-07-21T17:32" }, "checkOutDate": { "iso8601": "2017-07-21T17:32" } }, "searchBy": { "searchType": "AIRPORT", "airport": "LHR" } }, "filters": { "prepaidQualifier": "INCLUDE_PREPAID", "priceRange": { "min": { "amount": 510, "currencyCode": "GBP" }, "max": { "amount": 510, "currencyCode": "GBP" } }, "amenities": [ "ECO_FRIENDLY" ], "chainCodes": [ "string" ], "radius": { "length": 150, "unit": "MILE" }, "starRatings": [ 0 ], "nameQuery": "string", "eligibleForLoyalty": false, "showUnavailable": false, "payByPoints": false, "modifiableOnly": false, "rateTypes": [ "PUBLISHED" ], "propertyTypes": [ { "type": "ALL_SUITE", "description": "string" } ], "refundableOnly": false, "preferredOnly": false }, "sortOptions": [ { "sortBy": "PRICE", "sortOrder": "ASCENDING" } ], "userId": { "userIdType": "USER_ID", "userId": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" } }, "paginationParams": { "requestType": "PAGE_TOKEN", "pageToken": "token" } }'
OK
List of hotels matching the search criteria.
Unique key for the hotel details.
Includes detailed specifications for a hotel, such as name, star rating, address, coordinates, amenities, and other information.
Postal Address Details
Address lines
Code of administrative area. For example: DL for Delhi, India. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.
Name of administrative area. This is full name corresponding to administrativeArea. Like Delhi for DL area code. For some places, code and name maybe same as well like Tokyo.
Whether this address is default address in case multiple addresses are specified.
BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations. Examples: "zh-Hant", "ja", "ja-Latn", "en".
Generally refers to the city/town portion of the address.
IATA 3-letter location code. See https://www.iata.org/en/services/codes.
The name of the organization at the address.
Postal code of the address. This is a required field when setting for a user/legal entity/company etc.
2 letter continent code of the continent this address falls in.
Region code of the country/region of the address.
Region name of the country/region of the address.
Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
Sublocality of the address. This can be neighborhoods, boroughs, districts.
Time zone of the address.
Latitude and Longitude for a Location
Provides contact information for a hotel.
List of phone numbers for the hotel.
two digit country code
List of hotel amenities.
Amenity description
List of property types for the hotel.
Type of the property.
Details about hotel star rating.
Specifies the length or a distance.
Includes detailed information about a policy, such as its unique identifier, type, name, rules, version, and approval type.
Indicates if the hotel has negotiated rates.
Contains detailed rate information for a hotel search.
Rate details for hotel room
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Rate details for hotel room
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Set to true if the hotel rate is refundable.
Information about reward points earned.
Includes metadata for a hotel search.
A list of available hotel chains.
Contains statistical information about hotel search results.
Details median rate information for a hotel.
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Money object containing details such as the amount, the currency code, and the converted amount.
The numeric value for the amount of money.
The 3-letter currency code for the money amount (defined using ISO 4217 standard).
The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
Size of the sample set used to calculate the statistics.
Indicates if only base fare should be shown.
Pagination response for token based pagination. Contains the next page token(if next page is available) and pagination parameters.
{ "hotels": [ { … } ], "metadata": { "availableHotelChains": [ … ], "rateStatistics": { … }, "showOnlyBaseFare": false, "sessionId": "string" }, "paginationParams": { "nextPageToken": "string", "currentPageSize": 10 } }