Public API

Read published listing details and resolve current booking availability through a versioned JSON API.

GET

Listing details

/v1/public/listings/{publicId}

Returns the public guest-facing projection. Drafts and unknown IDs return the same not-found response.

GET

Availability

/v1/public/listings/{publicId}/availability?from=2026-08-01&to=2026-08-31&partySize=2

Request up to 43 inclusive dates. Party size defaults to one and must be between 1 and 100.

POST

Create a booking

/v1/public/bookings

Requires JSON and a 16–128 character Idempotency-Key. Successful bookings are confirmed immediately; the private management link is sent to the guest by email.

Contract notes

Dates and times use the listing timezone.
Availability is advisory until an atomic booking succeeds and is never statically cached.
Errors use stable JSON envelopes with a request ID and do not expose internal records.