---
title: "Resolve a place name to one or more destination ids"
method: POST
path: "/destinations/resolve"
tags: ["destinations"]
---

# Resolve a place name to one or more destination ids

`POST /destinations/resolve`

## Request

- Base URL: `https://api.b2a.bluepillow.com/v1`
- URL: `https://api.b2a.bluepillow.com/v1/destinations/resolve`
- Auth: HTTP bearer

## Headers

- `B2A-Version` string, date

## Request body

- ResolveRequest
  - `name` string, required
  - `country` string, nullable
  - `type` 'city' | 'neighborhood' | 'airport' | 'poi' | 'area', nullable
  - `language` 'en' | 'it' | 'fr' | 'de' | 'es' | 'pt' | 'nl' | 'ko' | 'pl' | 'ja'

## Response `200`

One or more candidate destinations

- ResolveResult
  - `candidates` Destination[], required
    - `id` string, required
    - `name` string, required
    - `display_name` string, required
    - `type` 'city' | 'neighborhood' | 'airport' | 'poi' | 'area', required
    - `country_code` string, nullable
    - `country_name` string, nullable
    - `location` DestinationLocation, required
      - `lat` number, required
      - `lon` number, required
      - `default_radius_km` number, required
    - `accomodations_count` integer, required
    - `path_breadcrumb` string[], required
    - `confidence` number, nullable
    - `distance_km` number, nullable
  - `total_matches` integer, required
  - `total_matches_capped_at` integer, nullable
  - `disambiguation_recommended` boolean, required

## Other responses

- `400`: Invalid request
- `401`: Auth missing or invalid
- `404`: No destination matched
- `429`: Rate limited

---

[API](https://skmtc.dev/bluepillow/apis/b2a-api.md) · [All operations](https://skmtc.dev/bluepillow/apis/b2a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bluepillow/apis/b2a-api/revisions/1dfd82be92b6?raw)