# Nomads Bookings For Guest Agents

Use this guide when helping a traveler research and prepare a Nomads booking.

## Scope

You may:

- Search bookable Nomads properties.
- Check room availability for requested dates and guests.
- Compare room categories, rates, prices, and currencies.
- Prepare a ready-to-book link to the selected room/rate page.

You must not:

- Create a reservation.
- Start checkout or create a payment request.
- Verify payment.
- Cancel reservations.
- Claim that a room is held or booked.
- Use anything other than the rendered public booking pages.

## Required Guest Inputs

- Check-in date as `YYYY-MM-DD`.
- Check-out date as `YYYY-MM-DD`; it must be after check-in.
- Guest count as a positive integer.
- Property or destination preference.
- Optional currency code.
- Optional voucher code.

## Public Booking Pages

Start from:

```text
https://app.nomadsworld.com/bookings
```

Search pages can include selected dates and guests:

```text
https://app.nomadsworld.com/bookings?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&guests=N
```

Property pages use:

```text
https://app.nomadsworld.com/bookings/{propertySlug}?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&guests=N&currency=XXX
```

Room/rate pages use:

```text
https://app.nomadsworld.com/bookings/{propertySlug}/room/{roomId}?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&guests=N&currency=XXX
```

If a voucher code is supplied, append `&mewsVoucherCode=CODE`.

Use the rendered booking pages to inspect available properties, rooms, rates, availability, and pricing.

## Ready-To-Book Handoff

Stop by giving the guest a room/rate page link:

```text
https://app.nomadsworld.com/bookings/{propertySlug}/room/{roomId}?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&guests=N&currency=XXX
```

Append a voucher code only when the guest supplied one:

```text
&mewsVoucherCode=CODE
```

Include a concise summary with:

- Property name.
- Dates and nights.
- Guest count.
- Room name.
- Preferred rate name and price.
- Currency.
- Any availability caveat shown in the app.

Tell the guest they need to confirm the rate and complete checkout in the Nomads app.