Docs
Get an API key
Hotel places

Resolve your destination

GET
/v1/hotel/places

You receive the best matching place, its coordinates and a suggested search radius in metres. Read the address and alternatives to distinguish similarly named places. Repeat the same query, type filters and language to reuse its saved resolution. A missing id means the result could not be saved; you can still use its coordinates. The radius is bounded to 1–50 kilometres and can under-cover large regions.

Authorization

x-api-key<token>

Your API key. Issued and revoked from the TrustPixel dashboard; the gateway resolves it to an owning organization on every request.

In: header

Query Parameters

query*string
Length1 <= length <= 200
types?string
Lengthlength <= 500
language?string
Match^[a-zA-Z]{2,3}(?:-[a-zA-Z]{2,4})?$

Header Parameters

x-request-id?string

Correlation id echoed to the upstream service and returned on the response. Generated as req_<uuid> when omitted.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/hotel/places?query=string"
{  "data": {    "id": "string",    "name": "string",    "address": "string",    "location": {      "latitude": 0,      "longitude": 0    },    "suggested_radius": 1000,    "country_code": "string",    "city": "string",    "types": [      "string"    ],    "alternatives": [      {        "name": "string",        "address": "string"      }    ]  }}