For AI agents

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.

The short version

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.

Home	Slug	listingId	Sleeps	Min nights	Neighborhood
Bird of Paradise	`bird-of-paradise`	`5f57ab032d83ee002da3a254`	10	3	Mid-City
The Bienvenue	`bienvenue`	`610860e5188f09002fcc9b6f`	10	3	Central City
The Spoonbill	`spoonbill`	`5fea685ca8dd7c003088ed1f`	8	3	Central City
Modern Swamp	`modern-swamp`	`60a57b32580761002edf87c4`	10	3	Mid-City
The Uptown	`uptown`	`5e9483609773a80046f01dc2`	8	3	Uptown
The Canopy	`canopy`	`6642a144a9001e00107dab3b`	10	2	Central City
The Nest	`nest`	`5fde289aa7719b002d972de6`	6	3	Central City
The Satsuma House	`satsuma`	`6a455a390f346f0014406cf2`	10	3	Uptown
Zen Paradise	`zen-paradise`	`60fb2e78588a40002dfe990f`	10	3	Central City
Water Wildlife	`water-wildlife`	`60e7947a462c0f002f058d6a`	10	3	Central City
The Second Line	`second-line`	`638fa7f6bc103600569eb63c`	10	3	Uptown
Afrofuture (NOAAM Partner)	`afrofuture`	`637d350f932637002efe9a0a`	10	2	Uptown
The Jungle	`jungle`	`60faf181588a40002dfa8e4f`	10	3	Central City
The Music Box	`traditional`	`6a2c16ec2b362900134682b3`	10	2	Uptown

Step 1: Check availability

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

-> { ok, blocked: ["YYYY-MM-DD", ...] }    dates NOT listed are open

Step 2: Quote the stay

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 }

Quotes are the same numbers as checkout; there is nothing hidden to add later. 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.

Step 3: Book it

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.

Good to know

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.