Quickstart

Make your first live accommodation search with the Direct Travel API in a few minutes.

Current Status (2026-10-16):

With the release of v3, our API documentation has been updated and republished. New sign-ups remain paused, but existing approved API keys can be used to access v3. While you can still create new API keys through the Stay22 Hub, these newly created keys will not be authorized to access the API until access has been granted.

Join the waitlist and we'll notify you when access becomes available.

This guide makes one working request to the Direct Travel API — a live search for hotels in Paris — and reads the response. Swap in any address or coordinates once it works.

Prerequisites

API key — pass an existing key in the X-API-KEY header or create one in the Hub.

Make a request

To search, call GET /v3/accommodations with a location and your key in the X-API-KEY header. Searches include all available suppliers.

curl -H "X-API-KEY: <API_KEY>" \
  "https://api.stay22.com/v3/accommodations?address=Paris"

Read the response

Each stay arrives in results[]. Every stay carries a top-level url (a Stay22 deeplink that already carries your aid) and a suppliers map keyed by supplier. Without dates the search is static — no prices yet.

{
  "meta": { "page": 1, "pageSize": 10, "total": 29758, "hasMore": true, "currency": "USD" },
  "results": [
    {
      "id": "42f1014f...0000",
      "name": "Appartement aux portes de Paris",
      "type": "Apartment",
      "url": "https://www.stay22.com/allez/roam/...?aid=<AID>",
      "suppliers": {
        "booking": { "link": "https://www.stay22.com/allez/booking/usds_42f1014f...0000?aid=<AID>" }
      }
    }
  ],
  "_links": { "next": { "href": "https://api.stay22.com/v3/accommodations?address=Paris&page=2" } }
}

Each suppliers.<name> entry has a booking link, that supplier's media, rating and policies, and (with dates) a price. Follow _links.next to page through results. See Response & supplier model.

Add dates for live prices

Without dates, the search returns static results (no prices). Pass checkin/checkout to get a per-supplier price for each stay:

curl -H "X-API-KEY: <API_KEY>" \
  "https://api.stay22.com/v3/accommodations?address=Paris&checkin=2026-07-01&checkout=2026-07-04"

Each supplier now carries a price.total (full-stay total in meta.currency), and meta echoes your window:

{
  "meta": { "page": 1, "pageSize": 10, "total": 18342, "hasMore": true, "currency": "USD", "nights": 3 },
  "results": [{ "suppliers": { "booking": { "price": { "total": 252 } } } }]
}

See Pricing & quotes.

Quickstart

Prerequisites

Make a request

Read the response

Add dates for live prices

What to read next

On this page