MescoMg Hotel API
📋 Change Log
| Date | Changed By | API | Description |
|---|---|---|---|
| 28 August 2026 | - | Search API | Clarified nationality codes, CustomRow usage, hotel-local cancellation penalty times, and USD pricing. |
| 27 August 2026 | - | All public APIs | Updated the customer-facing API contract and examples, added security guidance, and documented live/test base URLs. |
| 18 May 2026 | - | Booking List, Search, Booking, Static Data | Public API documentation update |
| 15 May 2025 | - | - | Base API |
🔗 API Base URLs
| Environment | Base URL |
|---|---|
| Live | https://mg.mescogo.com/gw |
| Test | https://mgtest.mescogo.net/gw |
All prices returned by the API are in USD. Cancellation penalty times are based on the hotel's local time and are returned without conversion to UTC or the customer's local timezone.
Use {BaseURL} in the endpoint examples below. Replace it with the base URL for the environment you are using; do not append /gw again.
📍 API Endpoints
| API | Endpoint |
|---|---|
| Search | {BaseURL}/api/price/mg-hotel-prices |
| Book | {BaseURL}/api/booking/book |
| Booking Detail | {BaseURL}/api/booking/booking-detail |
| Booking List | {BaseURL}/api/booking/book-list |
| Booking Cancel | {BaseURL}/api/booking/cancel |
| Service Status | {BaseURL}/api/service/Status |
| Country List | {BaseURL}/common/common/country-list |
| Region List | {BaseURL}/common/common/region-list |
| City List | {BaseURL}/common/common/city-list |
| Meal Types | {BaseURL}/common/hotel/meal-types |
| Hotel Code List | {BaseURL}/common/hotel/hotel-code-list |
| Hotel Detail | {BaseURL}/common/hotel/hotel-detail |
📊 Response status handling
The HTTP status and the status code inside a JSON response are separate values:
| Layer | Meaning |
|---|---|
HTTP 200 | The request reached the API. The JSON body can still contain a business or validation result in Status.Code or StatusCode. |
HTTP 400 | The request format or model validation failed. |
HTTP 401 | The Authorization header is missing, malformed, or not accepted. |
HTTP 404 | The requested resource or API credentials were not found. |
HTTP 409 | The request conflicts with the current availability or booking state. |
HTTP 500 | An unexpected server-side error occurred. |
For search and booking operations, handle the JSON body as well as the HTTP status. Common body status codes are 200 (successful), 201 (no availability), 404 (record or validation result not found), 409 (availability or booking conflict), and 500 (processing error). The exact response shape is documented on each endpoint page.