MescoMg Hotel API Specification
Version 1.0
📋 Change Log
| Date | Changed By | API | Description | Version |
|---|---|---|---|---|
| 18 May 2026 | - | Booking List, Search, Booking, Static Data | Updated customer documentation, including Booking List support for reservation operations | 1.0 |
| 15 May 2025 | - | - | Base API | 1.0 |
🔗 API Base URL
https://mg.mescogo.com/gw
📍 API Endpoints
| API | Endpoint |
|---|---|
| Search | https://mg.mescogo.com/gw/api/price/mg-hotel-prices |
| Book | https://mg.mescogo.com/gw/api/booking/book |
| Booking Detail | https://mg.mescogo.com/gw/api/booking/booking-detail |
| Booking List | https://mg.mescogo.com/gw/api/booking/book-list |
| Booking Cancel | https://mg.mescogo.com/gw/api/booking/cancel |
| Service Status | https://mg.mescogo.com/gw/api/service/Status |
| Country List | https://mg.mescogo.com/gw/common/common/country-list |
| Region List | https://mg.mescogo.com/gw/common/common/region-list |
| City List | https://mg.mescogo.com/gw/common/common/city-list |
| Meal Types | https://mg.mescogo.com/gw/common/hotel/meal-types |
| Hotel Code List | https://mg.mescogo.com/gw/common/hotel/hotel-code-list |
| Hotel Detail | https://mg.mescogo.com/gw/common/hotel/hotel-detail |
📊 Response Status
| Response Status | Status Code | Description | Remarks |
|---|---|---|---|
| SUCCESS | 200 | Successful | All Successful Registrations Return This 200 Code |
| NO_AVAILABILITY | 201 | No Availability | No available rooms with the specified features were found |
| BOOKING_FAIL | 405 | Booking Failed | An error occurred while creating a reservation |
| CANCEL_FAIL | 409 | Cancel Failed | An error occurred during the reservation cancellation phase |
| UNAUTHORIZED | 401 | Unauthorized use | Unauthorized Use |
| INVALID_REQUEST | 400 | Invalid Request | Request Format Not Compatible |
| UNEXPECTED_ERROR | 500 | Unexpected Error | An Unexpected Error Occurred |
| AGENT_BLOCKED | 423 | Agent Blocked | You are not allowed to use the system |