---
title: "Resolve travel locations"
description: "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."
---

> 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.

# Resolve travel locations

`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

```bash
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.wego.com/v1/places?query=VALUE"
```

Source: https://docs.wego.com/api/places/get-places/index.mdx