Skip to content

Get a single booking by UID

GET
/appointments/bookings/{booking_uid}

Return the full booking detail (attendees, references, meeting_url, responses, internal notes). Backed by BookingsHandler.handle_get; raises 404 when the UID isn’t visible to the caller.

Mirrors the list route: an organization key that holds the explicit meetings:read scope reads org-wide (so a uid returned by the list can be opened); any other key, and an org key without that scope, keeps the member-scoped path. org_id is always the principal’s (agency-targeted: the target) org, so another org’s booking stays 404.

Authorizations

Parameters

Path Parameters

booking_uid
required

Booking UID (uuid string).

string

Booking UID (uuid string).

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string