# Search hotel destinations (/docs/api-reference/hotels/get-destinations)

`GET /v1/hotels/destinations`

Finds the places to search hotels in by name: a country, a region, a city or a district.

Returns `{ items }`: at most `limit` places whose names match `q`, most relevant first, without
paging. Send a place's `id` as `searchCriteria.location.geoNodeId` in a search; it finds the
hotels of every place inside it. `name` includes the place's parents, for example "Downtown Dubai,
Dubai, United Arab Emirates", and `category` is its level: `country`, `region`, `city`
or `area`. Only places where OpenRoam has had hotels are listed.
            
`q` is required: plain text, at most 100 characters, without control characters. `countryCode`
keeps the places of one ISO 3166-1 alpha-2 country; `limit` is 1–100 (default 10). An invalid or blank
value, or any other query parameter, gives 400 / 10001. 503 / 10007 when the destination index is
unavailable or does not answer within 5 seconds: retry.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `q` | query | yes | `string` | Required. Free text over place names, for example `downtown dub`; at most 100 characters, without control characters. |
| `countryCode` | query | no | `string` | Optional ISO 3166-1 alpha-2 country, in either case: only places in that country. A blank value is rejected. |
| `limit` | query | no | `integer` | The most places to return, 1 to 100; default 10. |

## Responses

### 200

OK

- `text/plain`: `HotelDestinationList`
- `application/json`: `HotelDestinationList`
- `text/json`: `HotelDestinationList`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 503

Service Unavailable

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.