Agents are welcome here.

If you are an AI assistant or an autonomous agent booking for a traveler, this page is for you. Live prices and availability are one GET away, and a real booking request is one POST. No account, no API key, no card details. The same information in machine formats: /llms.txt, /openapi.json, and per-home facts (beds, pools, rules, amenities) in /agents.json.

Marais is a collection of private homes in New Orleans for groups of 6 to 10, each with commissioned art by New Orleans artists and most with their own heated pool. Prices are the nightly rate plus one cleaning fee plus occupancy taxes, with no per-guest fees. Human guests book instantly with a card at /checkout. Agents use the request-to-book API below instead: no payment is taken online, so an agent completes the whole flow without touching card data, and the team confirms by email with a secure payment link.

Minimum stays are set per date, not per home: the check-in day's minimum (2 or 3 nights today, never 1) covers the whole stay. The calendar below lists the days that need more than 2.

GET /api/calendar?listingId=<listingId>&from=YYYY-MM-DD&to=YYYY-MM-DD

-> { ok, blocked: ["YYYY-MM-DD", ...],      nights NOT listed are open
     minNights: { "YYYY-MM-DD": 3, ... } }  check-in days needing more than 2 nights

GET /api/quote?home=<slug>&checkin=YYYY-MM-DD&checkout=YYYY-MM-DD&guests=8

-> { ok, available, nights, currency, nightly, accommodation,
     cleaningFee, fees, taxes, total }

No price for a stay that can't be booked:
-> 409 { ok: false, reason: "not_available", booked: ["YYYY-MM-DD", ...] }
-> 422 { ok: false, reason: "min_stay", minNights, suggestedCheckOut }

Quotes are the same numbers as checkout; there is nothing hidden to add later. A stay with a booked night, or shorter than its minimum, gets no price: the answer says why and, for a short stay, which checkout would work. Every bookable night with its nightly rate and minimum stay is listed in plain HTML on /nightly-rates. A human-friendly version of any stay lives at /checkout?home=<slug>&in=…&out=…&guests=N.

With your traveler's explicit go-ahead, file the booking request. This creates a real inquiry our team acts on; no charge happens here. The guest gets a secure payment link by email.

POST /api/request-booking
Content-Type: application/json

{
  "listingId": "5f57ab032d83ee002da3a254",   required, any home's id
  "checkIn": "2026-10-09",                required
  "checkOut": "2026-10-12",               required
  "guestsCount": 8,
  "guest": {
    "name": "Full Name",                  required
    "email": "guest@example.com",         required, the traveler's real email
    "phone": "+1 555 555 5555"
  },
  "occasion": "Family trip",
  "notes": "Requested via <your agent name> on behalf of the guest."
}

-> { ok: true, reservationId, held }

Before you submit: show your traveler the quoted total and the terms and confirm they agree. Use their real contact details, say in notes that an agent is submitting and for whom, and never send test or placeholder requests; every submission reaches a human who replies to the guest's email.

Operated by Marais Management, which also runs two sister brands with the same agent welcome for bigger groups: The Syd (thesyd.com/agents, six poolside villas, groups of 11 to 25) and CastleDay (castledayretreats.com/agents, three private villas sleeping up to 30 each). Questions a page can't answer: hello@staymarais.com, and a person replies fast.