---
title: "Discover destinations within a radius of a coordinate"
method: POST
path: "/destinations/discover-near"
tags: ["destinations"]
---

# Discover destinations within a radius of a coordinate

`POST /destinations/discover-near`

## Request

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

## Headers

- `B2A-Version` string, date

## Request body

- DiscoverNearRequest
  - `lat` number, required
  - `lon` number, required
  - `radius_km` number
  - `type` 'city' | 'neighborhood' | 'airport' | 'poi' | 'area', nullable
  - `language` 'en' | 'it' | 'fr' | 'de' | 'es' | 'pt' | 'nl' | 'ko' | 'pl' | 'ja'

## Response `200`

Candidate destinations near the point (possibly empty)

- DiscoverResult
  - `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

## Other responses

- `400`: Invalid request
- `401`: Auth missing or invalid
- `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)