Reservation Detail V2 Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developers.momorooms.com/doc/gh-reservation/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "GH Reservation MCP server": {
    "url": "https://developers.momorooms.com/doc/gh-reservation/mcp"
  }
}

Close
POST /v2/reservations/detail

API to retrieve enriched reservation details for given criteria. Returns property info, room details, guest info, occupancy, per-room pricing, cancel penalties, and cancellation info for cancelled bookings. All monetary amounts are in the booking currency.

application/json
Body object Required

Request to fetch reservation list. Only one filter criteria can be provided at a time: partnerReservationIds, reservationIds, check-in date range (checkInFrom & checkInTo), or booking date range (bookedFrom & bookedTo).

One of:

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • reservations array[object]

      List of enriched reservation details. Omitted when empty.

      Hide reservations attributes Show reservations attributes object

      Enriched reservation detail. Fields vary based on bookingStatus: - BOOKED: bookingAmount, minSellablePrice (Hotel product type only), roomStays with cancelPenalties. No cancelDate/refundAmount. - CANCELLED: cancelDate, refundAmount, roomStays with cancellationInfo. No bookingAmount/minSellablePrice/cancelPenalties.

      • partnerReservationId string

        Reservation ID from the partner side.

      • reservationId integer(int64)

        momorooms reservation ID.

      • bookDate string(date-time)

        Date and time when the reservation was booked.

      • bookingStatus string

        Current status: BOOKED or CANCELLED.

      • checkInDate string(date)

        Check-in date (yyyy-MM-dd).

      • checkOutDate string(date)

        Check-out date (yyyy-MM-dd).

      • currency string

        Currency code for all monetary amounts in this reservation.

      • bookingAmount number

        Total booking amount. Present only for BOOKED status.

      • minSellablePrice number

        Minimum sellable price for the whole stay, in currency. Present only for BOOKED status and productType Hotel; omitted for Package reservations.

      • cancelDate string(date-time)

        Date/time when the reservation was cancelled (UTC). Present only for CANCELLED status.

      • refundAmount number

        Refund amount. Present only for CANCELLED status.

      • property object

        Property (hotel) information.

        Hide property attributes Show property attributes object
        • propertyId string

          momorooms property ID.

        • propertyName string

          Name of the property.

        • countryCode string

          ISO 3166-1 alpha-2 country code of the property.

      • roomStays array[object]

        Room stay details with enriched data. Present for both BOOKED and CANCELLED. May be absent when enrichment is unavailable (see error code 4043).

        Hide roomStays attributes Show roomStays attributes object

        Room stay with enriched details. For BOOKED bookings includes cancelPenalties and bookingAcknowledgementCode. For CANCELLED bookings includes cancellationInfo and cancelAcknowledgementCode.

        • id integer(int32)

          Room stay index (0-based).

        • roomId integer(int64)

          Room identifier, the same roomId returned by search and quote.

        • roomName string

          Room type name.

        • boardBasis object

          Board basis details matching the search/quote response.

          Hide boardBasis attributes Show boardBasis attributes object
          • id integer

            Partner-facing board basis ID (same as search/quote response).

          • name string

            Board basis name (e.g. Self Catering, Bed and Breakfast).

        • bookingAcknowledgementCode string

          Supplier booking confirmation code. Present only for BOOKED status, when available.

        • cancelAcknowledgementCode string

          Supplier cancellation confirmation code. Present only for CANCELLED status, when available.

        • guestCount object

          Room occupancy.

          Hide guestCount attributes Show guestCount attributes object
          • adultCount integer

            Number of adults.

          • childCount integer

            Number of children.

          • childAges array[integer]

            Ages of all children in this room.

        • guestDetails array[object]

          List of guests in this room.

          Hide guestDetails attributes Show guestDetails attributes object

          Guest information.

          • guestType string

            Guest type: AD (adult) or CH (child).

          • age integer

            Age of the guest. Typically present for children.

          • firstName string

            First name of the guest.

          • lastName string

            Last name of the guest.

          • primary boolean

            Whether this guest is the primary guest for the room.

        • guestContact object

          Contact details for the primary booking guest.

          Hide guestContact attributes Show guestContact attributes object
          • email string

            Email address of the primary booking contact.

          • phone string

            Phone number of the primary booking contact.

        • priceInfo object

          Room-level pricing.

          Hide priceInfo attribute Show priceInfo attribute object
          • roomTotal number

            Total room charges in the booking currency.

        • cancelPenalties array[object]

          Cancel penalty windows per room. Present only for BOOKED status.

          Hide cancelPenalties attributes Show cancelPenalties attributes object

          Cancel penalty window with dates and amount per room. Present only for BOOKED bookings.

          • penaltyStartDate string(date-time)

            Start of the penalty window (e.g. 2026-07-15T14:00:00+02:00).

          • penaltyEndDate string(date-time)

            End of the penalty window.

          • penaltyAmount number

            Penalty amount in the booking currency. Omitted when the penalty rule has no pre-calculated amount; the window dates are still returned.

        • cancellationInfo object

          Applied cancellation details per room. Present only for CANCELLED bookings.

          Hide cancellationInfo attributes Show cancellationInfo attributes object
          • cancellationReason string

            Reason for the cancellation.

          • penaltyWaived boolean

            Whether the cancellation penalty was waived.

          • penaltyAmount number

            Applied penalty amount in the booking currency. Zero when waived.

          • penaltyWindowStart string(date-time)

            Start of the applied penalty window.

          • penaltyWindowEnd string(date-time)

            End of the applied penalty window.

    • errors array[object]

      List of errors or warnings. Omitted when empty. With HTTP 200, may contain error code 4043 (PARTIAL_ENRICHMENT_FAILURE): some reservations could not be fully enriched and are returned without roomStays (property contains only propertyId). Retry later for full detail.

      Hide errors attributes Show errors attributes object
      • errorCode integer(int32)
      • errorDescription string
  • 400 application/json

    Client Side Error

    Hide response attribute Show response attribute object
    • errors array[object]
      Hide errors attributes Show errors attributes object
      • errorCode integer(int32)
      • errorDescription string
  • 500 application/json

    Server Side Error

    Hide response attribute Show response attribute object
    • errors array[object]
      Hide errors attributes Show errors attributes object
      • errorCode integer(int32)
      • errorDescription string

        Possible error responses:

        ErrorCode ErrorDesc
        500 An unexpected error occurred. Please try again later.

POST /v2/reservations/detail
curl \
 --request POST 'https://partner.momorooms.com/v2/reservations/detail' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "partnerReservationIds": [
    "string"
  ]
}'
Request examples
{
  "partnerReservationIds": [
    "string"
  ]
}
{
  "reservationIds": [
    42
  ]
}
{
  "checkInStartDate": "2026-05-04",
  "checkInEndDate": "2026-05-04"
}
{
  "bookingStartDate": "2026-05-04",
  "bookingEndDate": "2026-05-04"
}
Response examples (200)
{
  "reservations": [
    {
      "partnerReservationId": "string",
      "reservationId": 42,
      "bookDate": "2026-05-04T09:42:00Z",
      "bookingStatus": "string",
      "checkInDate": "2026-05-04",
      "checkOutDate": "2026-05-04",
      "currency": "string",
      "bookingAmount": 42.0,
      "minSellablePrice": 42.0,
      "cancelDate": "2026-05-04T09:42:00Z",
      "refundAmount": 42.0,
      "property": {
        "propertyId": "string",
        "propertyName": "string",
        "countryCode": "string"
      },
      "roomStays": [
        {
          "id": 42,
          "roomId": 42,
          "roomName": "string",
          "boardBasis": {
            "id": 42,
            "name": "string"
          },
          "bookingAcknowledgementCode": "string",
          "cancelAcknowledgementCode": "string",
          "guestCount": {
            "adultCount": 42,
            "childCount": 42,
            "childAges": [
              42
            ]
          },
          "guestDetails": [
            {
              "guestType": "string",
              "age": 42,
              "firstName": "string",
              "lastName": "string",
              "primary": true
            }
          ],
          "guestContact": {
            "email": "string",
            "phone": "string"
          },
          "priceInfo": {
            "roomTotal": 42.0
          },
          "cancelPenalties": [
            {
              "penaltyStartDate": "2026-05-04T09:42:00Z",
              "penaltyEndDate": "2026-05-04T09:42:00Z",
              "penaltyAmount": 42.0
            }
          ],
          "cancellationInfo": {
            "cancellationReason": "string",
            "penaltyWaived": true,
            "penaltyAmount": 42.0,
            "penaltyWindowStart": "2026-05-04T09:42:00Z",
            "penaltyWindowEnd": "2026-05-04T09:42:00Z"
          }
        }
      ]
    }
  ],
  "errors": [
    {
      "errorCode": 42,
      "errorDescription": "string"
    }
  ]
}
Response examples (400)
{
  "errors": [
    {
      "errorCode": 42,
      "errorDescription": "string"
    }
  ]
}
Response examples (500)
{
  "errors": [
    {
      "errorCode": 42,
      "errorDescription": "string"
    }
  ]
}