API reference/GET /public/booking-proposals/{public_proposal_access_token}

GET /public/booking-proposals/{public_proposal_access_token}

publicoptional rc

Poll safe public booking proposal status.

The status token returns safe public state only. It never exposes internal proposal IDs, private conflicts, audit rows, or owner availability.

Request

GET /public/booking-proposals/{public_proposal_access_token} HTTP/1.1

Returns 200 OK with the response body below.

200 OK · example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "pending_review",
  "updated_at": "2026-07-04T12:00:00.000Z"
}

Code	Description
`404`	Calendar owner or booking id not found.
`429`	Rate limit exceeded. Per-key limits: POST /v1/availability/search → 300 req/min; POST /v1/holds, POST /v1/bookings, and /v1/bookings/{hold_id}/confirm → 120 req/min each. A global fallback of 600 req/min per IP applies to all other endpoints. Read the Retry-After header for the exact backoff in seconds.