# API Versioning

## X-Places-Api-Version

`string`

**required**  
The version of the API to use.

Allowed:  
`2025-06-17`

---

# Responses

### `200 success`

```json
{
  "matched": true,
  "foreign_id": "string",
  "matches": [
    {
      "fsq_place_id": "string"
    }
  ]
}
```

### `400 bad request`

### `403 Place Resolve is not set up for this project.`

### `500 Unable to resolve external place ID.`

---

# Example cURL Request

```bash
curl --request GET \
     --url https://places-api.foursquare.com/places/resolve \
     --header 'X-Places-Api-Version: 2025-06-17' \
     --header 'accept: application/json'
```