MakeMyTrip Hotel Details API
Get a property's description, location, amenities, and photos.
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
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.