# Sort hotels

URL: https://docs.emergingtravel.com/docs/affiliate-api/hotel-search/sort-hotels/

Tags: affiliate

---



**Sandbox**

```
https://api-sandbox.worldota.net/api/b2b/v3/search/hotelsort/
```

**Production**

```
https://api.worldota.net/api/b2b/v3/search/hotelsort/
```




The call ranks the hotels in the region. The ranking is made the internal ETG algorithm.

> [!TIP]
> Use the call when you want to determine the order of the bookings to display in a third-party product.



## Sandbox limitations { #limitations }

> [!WARNING]
> Use only field values, IDs, API keys, and any static content from the sandbox environment within the sandbox. <strong>Do not use sandbox data in test or production environments, and do not mix data or configuration between different environments.</strong>




* The possible values for the `region_id` field are: `2011`, `2395`, `2734`, and `6053839`.
* The maximum value for the `hotels_limit` field is `250`.
* The maximum number of items in `hotels` is `250`.

## Request example


**Sandbox**

```shell
curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/search/hotelsort/' \
--header 'Content-Type: application/json' \
--data '{
  "region_id": 536,
  "sort_type": "b2b",
  "hotels_limit": 5
}'
```

**Production**

```shell
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/b2b/v3/search/hotelsort/' \
--header 'Content-Type: application/json' \
--data '{
  "region_id": 536,
  "sort_type": "b2b",
  "hotels_limit": 5
}'
```




## Request body



- **hotels_limit** *(Int, optional)*

  <p>The maximum number of the available hotels in the response.</p>


- **region_id** *(Int, required)*

  <p>The region ID.</p>


- **sort_type** *(String, optional)*

  <p>The sort order type. Is different for the B2B and B2C clients.</p>
  > [!NOTE]
  > * The possible values:
  >   * `b2b`.
  >   * `b2c`.





## Response



- **hotels** *([String])*

  <p>The hotel ID list that matches the request body.</p>





## Response example

```json
{
  "data": {
    "hotels": [
      "concorde_am_studio",
      "berlin_marriott_hotel_2",
      "novum_hotel_aldea_berlin_centrum",
      "nh_berlin_mitte",
      "best_western_premier_hotel_moa_berlin"
    ]
  },
  "debug": {
    "request": {
      "region_id": 536,
      "sort_type": "b2b",
      "hotels_limit": 5
    },
    "key_id": 7705,
    "validation_error": null
  },
  "status": "ok",
  "error": null
}
```

## Errors

The `error` field has the value specified in the headers below.

### `invalid_params`

* The `region_id` field is required.
* The `region_id` field is equal or greater than `0`.
* The `hotels_limit` field is equal or greater than `0`.
* The `sort_type` field is incorrect.

### `hotels_not_found`

An internal search error. Has `500` status code.