---
title: "getMultiHotelOffers"
method: GET
path: "/shopping/hotel-offers"
tags: ["shopping"]
---

# getMultiHotelOffers

`GET /shopping/hotel-offers`

## Query parameters

- `hotelIds` string[], required
- `adults` integer
- `checkInDate` string, date
- `checkOutDate` string, date
- `countryOfResidence` string
- `roomQuantity` integer
- `priceRange` string
- `currency` string
- `paymentPolicy` 'GUARANTEE' | 'DEPOSIT' | 'NONE'
- `boardType` 'ROOM_ONLY' | 'BREAKFAST' | 'HALF_BOARD' | 'FULL_BOARD' | 'ALL_INCLUSIVE'
- `includeClosed` boolean
- `bestRateOnly` boolean
- `lang` string

## Response `200`

OK

## Other responses

- `400` — Bad request: | Code | Title | |-----|-----| | 23 | PASSENGER TYPE NOT SUPPORTED | | 61 | INVALID CURRENCY CODE| | 137 | INVALID ADULTS OCCUPANCY REQUESTED| | 145 | DURATION PERIOD OR DATES INCORRECT| | 195 | SERVICE RESTRICTION| | 249 | INVALID RATE CODE| | 377 | MAX STAY DURATION IS EXCEEDED| | 381 | INVALID CHECK-IN DATE| | 382 | INVALID CHECK-OUT DATE| | 383 | INVALID CITY CODE| | 392 | INVALID HOTEL CODE| | 397 | INVALID NUMBER OF ADULTS| | 400 | INVALID PROPERTY CODE| | 404 | CHECK_OUT DATE MUST BE FURTHER IN THE FUTURE THAN CHECK-IN DATE| | 424 | NO HOTELS FOUND WHICH MATCH THIS INPUT| | 431 | CHECK-OUT DATE IS TOO FAR IN THE FUTURE THAN CHECK-IN DATE| | 424 | NO HOTELS FOUND WHICH MATCH THIS INPUT| | 431 | CHECK-OUT DATE IS TOO FAR IN THE FUTURE| | 450 | INVALID PROVIDER RESPONSE| | 451 | INVALID CREDENTIALS| | 562 | RESTRICTED ACCESS FOR THE REQUESTED RATES AND CHAINS| | 784 | PROVIDER TIME OUT| | 790 | RATE SECURITY NOT LOADED|
- `500` — Internal server error.

## Changes

- **2023-02-16** `f011d3107b10` — 1 info
  - the `query` request parameter `adults` became optional
- **2021-11-23** `4dfa3118b8ac` — 1 warning
  - deleted the `query` request parameter `pageOffset`
- **2021-10-15** `085c8583f77a` — 1 warning
  - deleted the `query` request parameter `rateCodes`
- **2021-10-05** `689a01a6f8fe` — 1 warning
  - deleted the `query` request parameter `childAges`

[Change history](https://skmtc.dev/amadeus4dev/apis/hotel-search-api/changes/shopping/hotel-offers/get.md)

---

[API](https://skmtc.dev/amadeus4dev/apis/hotel-search-api.md) · [All operations](https://skmtc.dev/amadeus4dev/apis/hotel-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amadeus4dev/hotel-search-api/revisions/0a9d7796f36e/schema)