---
title: "Read hotel search results"
description: "Ranked hotels; default 10, max 50 per page."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.wego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read hotel search results

`GET /v1/hotels/searches/{searchId}/results`

Ranked hotels; default 10, max 50 per page. searchComplete:true is terminal, false advisory; poll snapshotCandidateCount to equal, non-zero over spaced (not back-to-back) reads. No-match: searchComplete:true AND totalCandidates===0. ?refundable=true=cheapest-refundable; ?view=card=lean list.

Operation ID: `getHotelSearchResults`

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `searchId` | path | string | yes |  |
| `page` | query | integer | no |  |
| `pageSize` | query | integer | no |  |
| `sort` | query | `relevance` \| `price_asc` \| `price_desc` \| `star_desc` \| `review_score_desc` \| `distance_asc` | no |  |
| `currency` | query | string | no |  |
| `locale` | query | string | no |  |
| `min-star` | query | integer | no |  |
| `max-star` | query | integer | no |  |
| `min-review-score` | query | number | no |  |
| `min-price` | query | number | no |  |
| `max-price` | query | number | no |  |
| `refundable` | query | `true` \| `false` | no |  |
| `amenities` | query | string[] | no |  |
| `property-types` | query | string[] | no |  |
| `brands` | query | string[] | no |  |
| `chains` | query | string[] | no |  |
| `districts` | query | string[] | no |  |
| `view` | query | `default` \| `card` | no |  |

## Responses

| Status | Description |
|---|---|
| `200` | Ranked hotels (agent default) or the card projection. |
| `400` | Invalid request parameters. |
| `401` | Missing or invalid bearer token. |
| `404` | Unknown/expired search, or unknown hotel. |
| `429` | Rate limit exceeded; retry after the `Retry-After` seconds. |
| `502` | The upstream hotels service returned an invalid response. |
| `503` | The hotels service is unavailable; retry after the `Retry-After` seconds. |

## Example

```bash
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.wego.com/v1/hotels/searches/$SEARCH_ID/results"
```

Source: https://docs.wego.com/api/hotels/get-hotel-search-results/index.mdx