Parameters

All parameters are passed as URL query strings to https://www.stay22.com/allez/{provider}.

Required

Parameter	Type	Required	Default	Description
`aid`	string	Yes	—	Your Stay22 affiliate ID. Signup for free here.

Without an AID, there is no way for us to attribute a booking to you.

Allez needs to know where you're linking to — anywhere on Earth. Provide a street address, coordinates, a hotel name, or a combination of these.

Parameter	Type	Required	Default	Description
`address`	string	No	—	Destination address or place name. City + country is fine, but more specific is better (e.g., `Bell Centre Montreal Canada`).
`lat`	number	No	—	Latitude of the destination. Use with `lng`. Preferred over `address` for accuracy.
`lng`	number	No	—	Longitude of the destination. Use with `lat`.
`link`	string	No	—	URL-encoded direct OTA link. If you provide this, you can skip the other location params. Must be URL-encoded via `encodeURIComponent()`.
`hotelname`	string	No	—	Hotel name for fuzzy matching. See if you can combine with `address` for best results. Less reliable for chain hotels like `Four Seasons` — prefer `address` or coordinates.

Tip

If you have both address and lat/lng, coordinates take priority. The address is used as a fallback and for display context.

Parameter	Type	Required	Default	Description
`checkin`	string	No	—	Check-in date in `YYYY-MM-DD` format.
`checkout`	string	No	—	Check-out date in `YYYY-MM-DD` format.
`adults`	number	No	—	Number of adult guests.
`children`	number	No	—	Number of children.
`childrenAges`	string	No	—	Ages at check-in as comma-separated integers from 0 to 17, without spaces (e.g. `children=2&childrenAges=3,15`). Supply exactly one age per child. Omitted or invalid ages fall back to provider defaults.

Parameter	Type	Required	Default	Description
`campaign`	string	No	—	Campaign ID for tracking. Strongly recommended. Use it to distinguish clicks by source, page, or promotion. Can be repeated for multiple labels like so: `&campaign=blog&campaign=summer_2026`.

Important

If you're using separators, please use _ instead of -

For example: campaign=foo_bar results in one string as "foo_bar"

If you use campaign=foo-bar, your reporting will have campaign strings "foo" and "bar"

Parameter	Type	Required	Default	Description
`lang`	string	No	—	Language/locale hint for the landing page (e.g. `en`, `fr`).
`currency`	string	No	—	Preferred display currency (ISO 4217, e.g. `USD`).

Parameter	Type	Required	Default	Description
`roam`	boolean	No	—	Explicitly force or disable wildcard (AI) routing. Normally determined by the endpoint - `/allez/roam` enables it by default.
`provider`	string	No	—	Override the AI-selected provider in roam mode. Useful for testing. Only applies when using `/allez/roam`.

See Roam for how roam selects a provider.