Hotel Room Availability

Check Room Availability

Check available rooms and rates for a specific hotel.

Endpoint: POST /api/v1/hotels/{hotelId}/roomsAvailable

Parameters:

• hotelId (path, required): Hotel ID
• locale (query, optional): 2-letter language code (e.g., en, fr)

Request Body:

{
  "rooms": [
    {
      "adults": 2,
      "childrenBirthdates": ["2010-05-15"]
    }
  ],
  "startAt": "2024-06-15",
  "endAt": "2024-06-20"
}

Response:

{
  "requestId": "req-123",
  "possibilities": [
    {
      "name": "Deluxe Room",
      "description": "Elegant room with city view",
      "minCapacity": 1,
      "maxCapacity": 2,
      "allotmentAvailable": true,
      "facilities": [
        {
          "name": "WiFi",
          "iconUrl": "https://example.com/wifi-icon.png"
        }
      ],
      "bedChoices": [
        {
          "id": "bed-choice-1",
          "name": "King Bed",
          "totalPriceWithoutPromo": 500.00,
          "totalPriceWithPromo": 450.00,
          "currency": "EUR",
          "promotions": ["Early Bird 10%"],
          "cancelConditions": [
            {
              "deduction": 50.00,
              "refundable": true,
              "startAt": "2024-06-10T00:00:00Z",
              "endAt": "2024-06-15T00:00:00Z"
            }
          ]
        }
      ],
      "supplier": "Hotel Direct",
      "source": "Internal",
      "availabilityKind": "free_sale"
    }
  ],
  "expiresAt": "2024-06-10T12:00:00Z"
}

Get Room Policies

Retrieve detailed policies for specific room configurations.

Endpoint: POST /api/v2/hotels/roomsPolicies

Request Body:

{
  "requestId": "req-123",
  "roomsToBook": [
    {
      "bedCompositionId": "bed-choice-1",
      "promotionId": "promo-123"
    }
  ]
}

Response:

{
  "contractingConditions": "Standard terms and conditions apply...",
  "cancelConditions": [
    {
      "deduction": 50.00,
      "refundable": true,
      "startAt": "2024-06-10T00:00:00Z",
      "endAt": "2024-06-15T00:00:00Z",
      "currency": "EUR"
    }
  ]
}