Client API · v1

One hotel API across
every distributor

Gateway Stream aggregates hotel inventory from its connected distributors behind a single canonical shape. Search once, get rates from every source that answered, and book, read and cancel through the same four endpoints.

Start building Browse endpoints

Search a city

curl -X POST https://api.gatewaystream.com/api/v1/search \
  -H "x-api-key: gws_sandbox_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "checkIn": "2026-12-05",
    "nights": 2,
    "rooms": [{ "adults": 2, "childAges": [] }],
    "currency": "USD",
    "destination": { "city": "Harare", "country": "ZW" }
  }'

Quickstart

Key in hand to confirmed sandbox booking, in five calls you can paste into a terminal.

Booking flow

How search, book and cancel fit together, and the rules a rate key carries with it.

Sandbox and live

Two separate environments. Which one you reach is decided by the key you send — nothing else.

Errors

One error shape for every failure, and what each code means for your next move.

Every client-facing endpoint