Docs
Get an API key
Hotel search

Find hotels for your stay

POST
/v1/hotel/search

You receive available hotels and their cheapest current prices for your complete party. Supply one occupancy per room with each child's age. Search one city and country, or a point with a radius in metres. Check-out follows check-in by at most 99 nights. Use the returned hotel_id, or supplier_hotel_id with meta.supplier, with offers to get a bookable price; search prices are for comparison. To read the next page, send meta.pagination.next_cursor as cursor with the same search fields; stop when it is omitted rather than at a short or empty page, and expect no estimated total.

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

Header Parameters

x-request-id?string

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/hotel/search" \  -H "Content-Type: application/json" \  -d '{    "supplier": "LITEAPI",    "destination": {      "city": "Dubai",      "country_code": "AE"    },    "check_in": "2027-11-22",    "check_out": "2027-11-24",    "occupancy": [      {        "adults": 2,        "children": []      },      {        "adults": 2,        "children": []      }    ],    "guest_nationality": "GB",    "guest_residence": "GB",    "currency": "USD",    "limit": 10  }'
{  "data": [    {      "hotel_id": "htl_example",      "supplier_hotel_id": "lp1f2e3",      "name": "Example Marina Hotel",      "city": "Dubai",      "country": "AE",      "cheapest_price": {        "total": {          "amount": 600,          "currency": "USD"        }      }    }  ],  "meta": {    "supplier": "LITEAPI",    "pagination": {      "limit": 10,      "next_cursor": "REPLACE_WITH_RETURNED_CURSOR"    }  }}