Quickstart

Make your first two calls, resolve a place and find hotels, then pick the guide for what you are building.

You need an API key and a terminal. Nothing on this page books or charges anything.

Set your key and host

export BASE_URL=https://api.sandbox.oex.sh
export API_KEY=…   # from the TrustPixel dashboard

Keys and environments covers both hosts and the 401 you get without a key.

Resolve a place

Turn free text into coordinates and a search radius:

Request

curl "$BASE_URL/v1/hotel/places?query=Dubai%20Marina" \
  -H "x-api-key: $API_KEY"

You get back data.location, data.suggested_radius and, for a city, data.city and data.country_code.

Find hotels for a stay

Search a city for two adults. Use check-in and check-out dates in the future:

Request

curl -X POST "$BASE_URL/v1/hotel/search" \
  -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
  -d '{
    "destination": { "city": "Dubai", "country_code": "AE" },
    "check_in": "2026-11-10",
    "check_out": "2026-11-12",
    "occupancy": [{ "adults": 2, "children": [] }],
    "guest_nationality": "GB",
    "currency": "USD",
    "limit": 10
  }'