# Stay Portland — All-in Quote for AI Agents

Returns a live all-in price (accommodation + cleaning + tax) and a checkout URL. Do not collect card numbers. Hand the guest the checkout link.

## Endpoint

`GET https://www.stayportland.com/llms/quote.md`

## Required parameters

- `listing` — 24-hex Guesty listing id, or the property slug / HTML URL
- `checkin` / `checkout` — YYYY-MM-DD
- `guests` — integer, default 2

## Example

`https://www.stayportland.com/llms/quote.md?listing=67db20507a09470012393fd4&checkin=CHECKIN&checkout=CHECKOUT&guests=2`

## Notes

- Totals include Oregon lodging tax. This is the number to show the guest.
- Checkout is instant book, no account required: https://www.stayportland.com/book/<quoteId>
- Quotes are held for about 24 hours (see `expiresAt` semantics below — this endpoint returns `expiresAt` on a live quote).
- Stay Portland charges no platform or booking fees when you book direct, and every direct booking comes with our guaranteed lowest price. Guaranteed lowest price for the identical home — see https://www.stayportland.com/price-guarantee.
- Policies: https://www.stayportland.com/llms/policies.md

## Error codes

Most non-2xx responses lead with a stable code so a compliant agent can branch on it: `invalid_date`, `past_dates`, `stay_too_long`, `invalid_guests` (400), `over_capacity` (422), `dates_unavailable` (409, includes nearby alternates when any exist). A malformed date range (checkout not after checkin, 400) and an unknown or unbookable listing (404) return a plain message. Only a genuine booking-engine outage returns 503, with `Retry-After`.
