Hotel API (v2)

Download OpenAPI description

HotelApi.json

HotelApi.yaml

Servers

Staging URL

https://apis.spotnana.com/

Spotnana mock server

https://developer.spotnana.com/_mock/openapi/hotelapi/

Hotel

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.

Operations

Autocomplete

Operations

Hotel Supplier Autocomplete

Request

This endpoint provides autocomplete suggestions for hotels based on the query provided.

Query

querystringrequired

Query to get autocomplete response

Example: query=New York Marquis

curl -i -X GET \
  'https://apis.spotnana.com/v2/hotel-supplier-autocomplete?query=New%20York%20Marquis' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

hotelsArray of objects(AutocompleteHotel)required

List of Hotels matching the Autocomplete query

hotels[].hotelCodestring

Unique Code for the hotel

Example: "100259788"

hotels[].hotelNamestringrequired

Full Name of the hotel

Example: "Delphin Deluxe Resort"

hotels[].locationobject(Location)

Location details

hotels[].addressobject(PostalAddress)

Postal Address Details

hotels[].isPresentInPreferredVendorsboolean

Whether the hotel is present in preferred vendor list. This is an optional field which gets populated only in the preferred vendor autocomplete API.

Example: true

hotels[].brandCodestring

The code of hotel brand.

Example: "MC"

hotels[].chainCodestring

The code of hotel chain.

Example: "EM"

hotels[].starRatingobject(HotelStarRatingInfo)

Hotel star rating detail.

hotels[].contactInfoobject(ContactInfo)

Contact information for the hotel.

Response

application/json

{
  "hotels": [
    { … }
  ]
}