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
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-Afterwhen supplied. - 504 UPSTREAM_TIMEOUT: the provider request timed out.