Availability Multi

Multi-property availability results using chain credentials

GET https://api.rateparity.com/v1/availability/multi

Returns multi-property availability for a chain code. Results include hotel metadata, lowest available rates, and filter metadata used for UI facets.

Query Parameters

Name	Type	Description
chainCode*	String	Chain code used to resolve availability credentials and property list.
checkin*	Date	Check-in date in YYYY-MM-DD format.
checkout*	Date	Check-out date in YYYY-MM-DD format.
adults	Integer	Number of adults (must be greater than zero).
children	Integer	Number of children.
infants	Integer	Number of infants.
rooms	Integer	Number of rooms.
currency*	String	Target currency code for prices.
device	String	Visitor device; DESKTOP (default) or MOBILE.
lang	String	Language code passed to the availability engine.
sortBy	String	Sort field; one of PRICE, POPULARITY, NAME, or DISTANCE.
sortOrder	String	Sort order; ASC or DESC.
minPrice	Double	Minimum price filter.
maxPrice	Double	Maximum price filter.
destination	String	Destination name filter.
rating	Array	Hotel rating filter; can be repeated for multiple ratings.
boards	Array	Hotel boards filter; can be repeated for multiple boards.
propertyName	String	Property name search substring.

200: OK Availability returned

{
  "hotels": [
    {
      "code": "WOLAWARSAW",
      "name": "White Olive Elite Warsaw",
      "description": "City center hotel with rooftop pool",
      "url": "https://hotel.example.com/WOLAWARSAW",
      "targetUrl": "https://hotel.example.com/WOLAWARSAW/book",
      "includeInWidgetSearch": true,
      "rating": 5,
      "minprice": 210.0,
      "nightsMin": 1,
      "nightsMax": 14,
      "symbol": "€",
      "photo": "https://images.example.com/WOLAWARSAW/main.jpg",
      "photoM": "https://images.example.com/WOLAWARSAW/main_m.jpg",
      "photoL": "https://images.example.com/WOLAWARSAW/main_l.jpg",
      "location": {
        "name": "Warsaw",
        "lat": 52.2297,
        "lon": 21.0122
      },
      "beds": 2,
      "bathrooms": 1,
      "bedrooms": 1,
      "noOfPhotos": 12,
      "rates": [
        {
          "rate": "NRF",
          "room": "Deluxe City View",
          "board": 1,
          "price": 210.0,
          "discount": 0.0,
          "memberPrice": 200.0,
          "memberDiscount": 10.0,
          "remaining": 6
        },
        {
          "rate": "RF",
          "room": "Deluxe City View",
          "board": 2,
          "price": 230.0,
          "discount": 10.0,
          "remaining": 3
        }
      ]
    }
  ],
  "metadata": {
    "destinations": {
      "Warsaw": 1
    },
    "boards": {
      "1": 1,
      "2": 1
    },
    "ratings": {
      "5": 1
    },
    "minPrice": 210.0,
    "maxPrice": 230.0,
    "sortBy": "PRICE",
    "sortOrder": "ASC"
  },
  "checkin": "2026-04-18",
  "checkout": "2026-04-19",
  "adults": 2,
  "currency": "EUR",
  "symbol": "€"
}

400: Bad Request Validation failed (e.g., missing required parameters or invalid dates)

401: Unauthorized Chain code could not be resolved or credentials are invalid

Example

curl

curl 'https://api.rateparity.com/v1/availability/multi?chainCode=chaincode&checkin=2026-04-18&checkout=2026-04-19&adults=2¤cy=EUR'