---
title: "Resolve Destination"
method: GET
path: "/agent-hotels/destinations/resolve"
tags: ["agent-hotels"]
---

# Resolve Destination

`GET /agent-hotels/destinations/resolve`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/agent-hotels/destinations/resolve`
- Auth: none declared

A traveler's words or an airport code to the catalog slug the searches take.

"Denver" and "DEN" give ``denver-us``; "near Times Square" gives
``new-york-us`` with the Times Square area; "Paris, Texas" is told apart
from Paris by the resolver's point. No account, no supplier call; the
answer is cached for an hour.

## Query parameters

- `q` string, required
- `country` string, nullable

## Headers

- `X-Axel-Flight-Source` string, nullable
- `X-Axel-Flight-Source-Signature` string, nullable

## Response `200`

Successful Response

- HotelDestinationResolution: Free text or an airport code mapped to the catalog slug the searches accept. ``destination`` is the whole city to search; ``area`` is the child area that holds the point when the words named a neighborhood or landmark (pass it as ``intent.area``). ``candidates`` lists alternatives when the words were ambiguous or no coverage circle holds the point.
  - `query` string, required
  - `status` 'resolved' | 'ambiguous' | 'unknown', required
  - `place` HotelResolvedPlace: What the traveler's words meant, from the Content place resolver.
    - `label` string, required
    - `short_label` string, required
    - `type` string, required
    - `latitude` number, required
    - `longitude` number, required
    - `radius_km` number, required
    - `country_code` string, nullable
  - `destination` HotelCatalogDestination
    - `id` string, required
    - `name` string, required
    - `country` string, required
    - `parent_id` string, nullable
    - `has_areas` boolean
    - `scope` string, nullable
    - `aliases` string[]
    - `hotel_count` integer, nullable
  - `area` HotelCatalogDestination
    - `id` string, required
    - `name` string, required
    - `country` string, required
    - `parent_id` string, nullable
    - `has_areas` boolean
    - `scope` string, nullable
    - `aliases` string[]
    - `hotel_count` integer, nullable
  - `candidates` HotelCatalogDestination[]
    - `id` string, required
    - `name` string, required
    - `country` string, required
    - `parent_id` string, nullable
    - `has_areas` boolean
    - `scope` string, nullable
    - `aliases` string[]
    - `hotel_count` integer, nullable
  - `airports` string[]

## Other responses

- `422`: Validation Error

## Changes

> 82 revisions in range; 1 not diffed.

- **2026-10-20** `721f508f8a45`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/agent-hotels/destinations/resolve/get.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) - [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/5d2bae0deed4?raw)
