Browse documentation
GET

MakeMyTrip Hotel Details API

Get a property's description, location, amenities, and photos.

Overview

Get MakeMyTrip hotel descriptions, address, coordinates, amenities, arrival times, and public photos for an Indian property using its hotel ID and stay context.

Scope

Use hotel_id and city_code from Search with the same stay context. This endpoint returns static hotel content, not room inventory or a booking quote. Missing descriptions, location fields, stars, or arrival times can be null; photo and amenity lists can be empty.

Authentication

Send your StayAPI key in the X-API-Key header. Successful requests return JSON; failures use RFC 7807 Problem Details.

Endpoint URL

GET https://api.stayapi.com/v1/makemytrip/hotel/details

Parameters

Parameter Type Required Description
hotel_id string Required Numeric MakeMyTrip hotel ID from Search, 1 to 32 digits. Keep it as a string.
city_code string Required MakeMyTrip India city code, 2 to 32 letters or digits. For example CTBLR (Bengaluru) or CTGOI (Goa).
check_in date Required Check-in date, YYYY-MM-DD; today or later.
check_out date Required Check-out date, YYYY-MM-DD; after check-in, with a maximum stay of 30 nights.
adults integer Optional Adults, 1 to 8. Default: 2.
rooms integer Optional One room only. Default and only accepted value: 1.
child_ages integer[] Optional At most four child ages, each 0 to 17. Repeat the parameter: child_ages=6&child_ages=10. Omit for no children.

Response schema

Examples are illustrative. Prices and available content depend on the requested stay and property.

Field Type Description
success boolean True for a successful response.
hotel.hotel_id / hotel.name string Stable numeric hotel ID and property name.
hotel.short_description / hotel.description string|null Published plain-text descriptions.
hotel.address object Nullable line1 and line2 address fields.
hotel.city_code / city / country_code / country string|null Published location identifiers and names.
hotel.latitude / longitude / stars number|null Coordinates and star classification.
hotel.check_in_time / check_out_time string|null Published arrival and departure times.
hotel.amenities / hotel.photos string[] Amenity names and public image URLs.

Errors and limitations

Errors use RFC 7807 Problem Details with provider: "makemytrip", and a correlation id when supplied.

  • 400 INVALID_INPUT: invalid stay dates, city code, occupancy, or a cursor from another search.
  • 401 / 402 / 429: check your API key, available quota, and account limits.
  • 422: a required parameter is missing or outside its declared type, range, or enum.
  • 502 UPSTREAM_ERROR: MakeMyTrip could not complete the request.
  • 503: service temporarily unavailable. Honor Retry-After when supplied.
  • 504 UPSTREAM_TIMEOUT: the provider request timed out.

Related MakeMyTrip endpoints