Ask the team · Bywater, New Orleans
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. You can read every price on this site without JavaScript, check availability day by day, and file a real booking request by API. No account, no API key, no card details. The same information in machine formats: /llms.txt, /openapi.json, and room-by-room bed maps in /agents.json.
The short version
Three villas, one block, live prices, bookable by API.
CastleDay Retreats is three private villas side by side in the Bywater, New Orleans. Each has 12 bedrooms, 17 beds and 8 baths and sleeps up to 30; the full three-villa buyout sleeps 90. Pricing is the nightly rate plus one cleaning fee per villa plus occupancy taxes, with no per-guest fees, and stays of 4+ nights get 5% off automatically. Booking direct at /checkout is instant: card payment runs through Guesty's secure payment form, the 50% deposit confirms the dates on the spot, and the balance auto-charges 60 days before check-in. Agents can't handle card details, so use the request-to-book API below instead: no payment is taken online, and the reservation team emails the guest a secure payment link.
herald · listingId 6795b986bc94280012d9222a · villa pagecocodrie · listingId 6766bfc56f511100136a5338 · villa pageflorentine · listingId 6788490e7f4af50013e65268 · villa pagebuyout · all three villas, sleeps 90Step 1
Check availability.
Day-level availability and nightly prices, per villa:
GET /api/calendar?listingId=<listingId>&from=YYYY-MM-DD&to=YYYY-MM-DD
-> { ok, days: [ { date, status, price, minNights, notOpen } ] } A date is bookable when status is "available". Ignore the price on any day with notOpen: true; it is beyond the booking window.
Step 2
Quote the stay.
Plain HTML, easy to share with your traveler (totals, per-night and per-person splits):
GET /quote?villa=herald&checkin=2026-10-09&checkout=2026-10-11&guests=20
The same numbers as JSON:
GET /api/quote?villa=herald&checkin=2026-10-09&checkout=2026-10-11&guests=20
-> { ok, available, nights, currency, accommodation, cleaningFee, taxes, total } villa is herald, cocodrie, florentine or buyout. Quotes are the same numbers as checkout; there is nothing hidden to add later. Typical nightly rates by month are on /rates, and every bookable night with its nightly rate and minimum stay is listed in plain HTML on /nightly-rates.
Step 3
Book it.
With your traveler's explicit go-ahead, file the booking request. This creates a real inquiry our reservation team acts on. No charge happens here; the guest pays later through a secure link we email them.
POST /api/request-booking
Content-Type: application/json
{
"name": "Full Name", required, first and last
"email": "guest@example.com", required, the traveler's real email
"phone": "+1 555 555 5555",
"checkIn": "2026-10-09", required
"checkOut": "2026-10-11", required
"listingId": "6795b986bc94280012d9222a", required, any villa's id
"villas": ["The Herald"], which villa(s) the group wants
"guests": 20,
"occasion": "Bachelorette",
"notes": "Requested via <your agent name> on behalf of the guest."
}
-> { ok: true, reservationId } Before you submit: show your traveler the quoted total and the terms (cancellation, payment schedule, house rules) 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 will reply to the guest's email. If you would rather hand off to a person, the human checkout is at /checkout.
Good to know
The fine print, findable.
Ask the team · 1319 Japonica Street · Bywater · New Orleans · Terms · Privacy