Appointments
Retrieve an Appointment
Retrieves a single Appointment by ID. Use this endpoint when you have an appointment ID returned by listShopAppointments, createBasketAppointmentItem, or a webhook payload, and need the canonical record — including its current status, stage, assigned Practitioners, Room, guest associations, and order context.
get/shop/appointments/{appointmentId}
Response
The Appointment was successfully retrieved.
Example response
{
"data": {
"appointment_type_name": "60 minute massage",
"currency": "gbp",
"duration": 60,
"email": "janedoe@example.com",
"end_buffer": 15,
"end_time": "2019-01-15T13:00:00+01:00",
"first_name": "Jane",
"full_name": "Jane Doe",
"guests": [
{
"id": "5dcb47800000000000000000",
"checked_in_at": "2025-10-01T12:00:00+00:00",
"checked_out_at": "2025-10-01T16:30:00+00:00",
"customer_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
"email": "jane.doe@example.com",
"first_name": "Jane",
"intake_form_submission_id": "5dcb47800000000000000010",
"last_name": "Doe",
"name": "Jane Doe"
}
],
"has_notes": true,
"has_outstanding_balance": true,
"has_special_requests": true,
"is_group_booking": true,
"is_hotel_room_booking": true,
"is_locked": true,
"is_part_of_package": true,
"last_name": "Doe",
"net_total": 4950,
"order_labels": [
{
"color": "#FF0000",
"name": "VIP"
}
],
"order_locked_at": "2019-01-15T12:00:00+01:00",
"order_ref": "TRY00",
"package_product_code": "MAS123",
"phone": "+447727123456",
"practitioners": [
{
"id": "5dcb47800000000000000000",
"name": "Jane Doe"
}
],
"product_code": "MAS123",
"room": {
"id": "5dcb47800000000000000000"
},
"start_time": "2019-01-15T12:00:00+01:00",
"submitted_at": "2019-01-15T12:00:00+01:00",
"total_cost": 5000,
"created_at": "2025-02-04T12:00:00+01:00",
"updated_at": "2025-02-04T12:00:00+01:00"
}
}Changes
No recorded changes to this endpoint across all 1 revision of this API.