Skip to main content

Overview

Returns the current status and details of a single booking that belongs to your partner account. Use this endpoint to poll for status changes (e.g. after creating a booking in waiting payment status) or to fetch the latest appointment information.

Endpoint

Authentication

Requires a valid API Key with the partner_bookings_read permission.

Path Parameters


Example Request


Success Response

HTTP Status: 200 OK

Error Responses


Notes

  • You can look up a booking by bookingId via this endpoint. Store the bookingId returned from POST /partners/bookings alongside your externalReference for later lookups.
  • The appointment field is null until a service appointment has been assigned.
  • paymentStatus reflects the most up-to-date payment state including PARTNER-side payment confirmations.

  • PATCH /partners/bookings/:bookingId/cancel — Cancel the booking