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
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.wego.com/v1/hotels/searches/$SEARCH_ID/results"