Skip to main content
POST
Book a viewing
Creates a viewing booking. The broker is notified immediately and can confirm, propose a new time, or decline.

Request body

uuid
required
The ID of the property to view.
ISO 8601 timestamp
required
When the viewing should happen. Must match one of the broker’s available slots — check with the availability endpoint first.
string
Override the phone number the broker will call you on. Defaults to the phone on the buyer’s profile.
string
Optional note visible to the broker, e.g. “coming with my wife”.

Response

object
boolean
Whether a lead credit was charged to the broker’s workspace for this booking.

Example

Errors

  • slot_unavailable — the requested time isn’t a broker-open slot.
  • slot_already_booked — someone else booked this slot first.
  • property_not_found — the property_id doesn’t exist or is unpublished.
  • self_booking_forbidden — you can’t book your own listing.