Availability

Reservation Availability

This API endpoint is used to check the availability for reservations.

Request

Method: POST

Base URL: {{baseUrl}}

Endpoint: /Reservation/Availability

Request Body

checkInDate (string): The check-in date for the reservation.

checkOutDate (string): The check-out date for the reservation.

adultNo (string): The number of adults for the reservation.

childNo (string): The number of children for the reservation.

facilityTypeId (string): The ID of the facility type.

Response

The response for this request is in JSON format and follows the schema below:

{
  "type": "object",
  "properties": {
    "errorCode": {
      "type": "number"
    },
    "errorMessage": {
      "type": "string"
    },
    "types": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "facilityTypeId": {
            "type": "number"
          },
          "roomTypeId": {
            "type": "number"
          },
          "roomType": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          },
          "adult": {
            "type": "number"
          },
          "children": {
            "type": "number"
          },
          "currencySymbol": {
            "type": "string"
          },
          "rateId": {
            "type": "number"
          },
          "rate": {
            "type": "number"
          },
          "available": {
            "type": "number"
          },
          "image1": {
            "type": "string"
          },
          "image2": {
            "type": "string"
          },
          "image3": {
            "type": "string"
          },
          "image4": {
            "type": "string"
          },
          "image5": {
            "type": "string"
          },
          "image6": {
            "type": "string"
          },
          "image7": {
            "type": "string"
          },
          "image8": {
            "type": "string"
          }
        }
      }
    }
  }
}

curl --location --request POST 'https://guestapi.roomability.io/Reservation/Availability' \ --header 'X-API-Key: {{api-key}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "checkInDate": "2025-09-15", "checkOutDate": "2025-09-16", "adultNo": "2", "childNo": "1", "facilityTypeId": 1, "sortBy": 1 }'

{ "errorCode": 0, "errorMessage": "Successfully retrieved available rooms.", "types": [ { "facilityTypeId": 1, "roomTypeId": 1, "roomType": "First Class Suite", "summary": "", "detail": "", "adult": 2, "children": 2, "currencySymbol": "₦", "rateId": 1, "rate": 60000, "available": 1, "image1": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image2": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image3": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image4": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image5": "", "image6": "", "image7": "", "image8": "" }, { "facilityTypeId": 1, "roomTypeId": 2, "roomType": "Business Suite", "summary": "", "detail": "", "adult": 2, "children": 2, "currencySymbol": "₦", "rateId": 2, "rate": 50000, "available": 1, "image1": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image2": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image3": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image4": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image5": "", "image6": "", "image7": "", "image8": "" }, { "facilityTypeId": 1, "roomTypeId": 3, "roomType": "Premium Suite", "summary": "", "detail": "", "adult": 2, "children": 2, "currencySymbol": "₦", "rateId": 3, "rate": 40000, "available": 3, "image1": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image2": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image3": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image4": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image5": "", "image6": "", "image7": "", "image8": "" }, { "facilityTypeId": 1, "roomTypeId": 4, "roomType": "Economy", "summary": "", "detail": "", "adult": 2, "children": 2, "currencySymbol": "₦", "rateId": 4, "rate": 35000, "available": 2, "image1": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image2": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image3": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image4": "https://api.reservations.ng/images/hotels/room-placeholder.png", "image5": "", "image6": "", "image7": "", "image8": "" } ] }

Reservation Availability#

Request#

Request Body#

Response#

Request

Responses

Reservation Availability

Request

Request Body

Response