Skip to main content
GET
/
api
/
public
/
bookings
/
{id}

Get Booking Details

Returns the complete details of a specific booking, including resource, time range, and pricing information.

Authentication

Requires a valid customer bearer token.

Path Parameters

id
number
required
Numeric identifier of the booking.

Query Parameters

_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation. Example: _shape=Booking.ResourceName,Booking.FromTime,Booking.ToTime,Resource.Name.

Response

Returns a Booking object with the following fields:

Identity

FieldTypeDescription
IdnumberUnique identifier for the booking
UniqueIdstringGUID identifier
BookingNumbernumber?Sequential booking number

Resource

FieldTypeDescription
ResourceResourceFull resource object (nested)
ResourceIdnumberResource identifier
ResourceNamestringDisplay name of the booked resource
ResourceTypeIdnumberResource type identifier
ResourceTypeNamestringResource type name
ResourceBusinessIdnumberBusiness identifier for the resource
ResourceBusinessNamestringBusiness name for the resource
ResourceBusinessWebAddressstringBusiness web address
ResourceUpdatedOnUtcstring?When the resource was last updated (UTC)

Floor Plan

FieldTypeDescription
FloorPlanDeskFloorPlanDeskFloor plan desk object (nested)
FloorPlanDeskIdnumber?Floor plan desk identifier
FloorPlanDeskNamestringFloor plan desk name

Schedule

FieldTypeDescription
FromTimestringBooking start time (local)
ToTimestringBooking end time (local)
FromTimeUtcstringBooking start time (UTC)
ToTimeUtcstringBooking end time (UTC)
UtcFromTimestringAlias for FromTimeUtc
UtcToTimestringAlias for ToTimeUtc
CheckedInAtstring?When the user checked in (local)
UtcCheckedInAtstring?When the user checked in (UTC)

Coworker

FieldTypeDescription
CoworkerCoworkerCoworker who made the booking (nested)
CoworkerIdnumberCoworker identifier

Status & Billing

FieldTypeDescription
TentativebooleanWhether the booking is tentative
IsCancelledbooleanWhether the booking has been cancelled
RecurringbooleanWhether this is a recurring booking
CancelIfNotPaidbooleanAuto-cancel if invoice not paid
InvoicedbooleanWhether the booking has been invoiced
CoworkerInvoiceIdnumber?Associated invoice identifier
CoworkerInvoicePaidbooleanWhether the invoice has been paid
CoworkerInvoiceNumberstringInvoice number
CoworkerExtraServicePricenumber?Price of extra services

Other

FieldTypeDescription
NotesstringBooking notes
ZoomDatastringZoom meeting data
IncludeZoomInvitebooleanWhether to include Zoom invite
CustomFieldsCustomField[]Array of custom field values

Timestamps (from base)

FieldTypeDescription
CreatedOnstringRecord creation timestamp (local)
UpdatedOnstringRecord last-update timestamp (local)
CreatedOnUtcstringRecord creation timestamp (UTC)
UpdatedOnUtcstringRecord last-update timestamp (UTC)

Examples

Fetch booking details

GET /api/public/bookings/1234
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

const { resource: booking } = useTypedData(httpClient, endpoints.bookings.one(1234))