Find hotels for your stay
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.
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
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" } }}Read a saved destination GET
You retrieve the resolution using the service's plc_ ID from your place search. This read makes no supplier request.
Price your selected hotels POST
You price up to 10 hotels for the same stay and room occupancies; split a longer search page across several requests. You name them by the service's hotel_ids, or by supplier with that supplier's supplier_hotel_ids from search, never both. You request at most 250 offers in total, hotel IDs times max_offers_per_hotel, to bound the response. Request hotels from one supplier at a time. Each returned offer_reference binds the complete room selection, stay, source market and price to your organization. Pass it to prebook before expires_at. You receive every room in rooms, in your requested occupancy order, with its available display and cancellation terms. Top-level room_type and board remain first-room summaries; total and any offer-level policy cover the whole stay and are counted once. You review the confirmed terms again after prebook. Promotions list each promotion once with the room positions it applies to; the total already includes them. Amounts use major currency units.