GET /v1/places
Resolves a free-text location query to canonical Wego places (cities, airports, states, districts, hotels) with codes and coordinates, for use in later flight and hotel searches. When metadata.hasAmbiguity is true, clarify with the user before proceeding.
Operation ID: getPlaces
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
query |
query | string | yes | |
types |
query | string[] | no | Place types to resolve; repeat or comma-separate to mix. |
locale |
query | string | no | |
page |
query | integer | no | |
pageSize |
query | integer | no |
Responses
| Status | Description |
|---|---|
200 |
Matching places plus pagination/ambiguity metadata. |
400 |
Invalid query parameters. |
401 |
Missing or invalid bearer token. |
429 |
Rate limit exceeded; retry after the Retry-After seconds. |
502 |
The upstream places service returned an invalid response. |
503 |
The places service is temporarily unavailable; retry after the Retry-After seconds. |
Example
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.wego.com/v1/places?query=VALUE"