### Get a Booking Endpoint Definition
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking
This OpenAPI definition outlines the GET request for retrieving a specific booking using its UID. It specifies required headers like 'cal-api-version' and optional authentication headers.
```yaml
openapi: 3.0.0
info:
title: Cal.com API v2
description: ''
version: 1.0.0
contact: {}
servers: []
security: []
tags: []
paths:
/v2/bookings/{bookingUid}:
get:
tags:
- Bookings
summary: Get a booking
description: |-
`:bookingUid` can be
1. uid of a normal booking
2. uid of one of the recurring booking recurrences
3. uid of recurring booking which will return an array of all recurring booking recurrences (stored as recurringBookingUid on one of the individual recurrences).
If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or
you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner.
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
operationId: BookingsController_2026_02_25_getBooking
parameters:
- name: cal-api-version
in: header
description: Must be set to 2026-02-25.
required: true
schema:
type: string
default: '2026-02-25'
- name: bookingUid
required: true
in: path
schema:
type: string
- name: Authorization
in: header
description: >-
value must be `Bearer ` where `` is api key prefixed
with cal_, managed user access token, or OAuth access token
required: false
schema:
type: string
- name: x-cal-secret-key
in: header
description: For platform customers - OAuth client secret key
required: false
schema:
type: string
- name: x-cal-client-id
in: header
description: For platform customers - OAuth client ID
required: false
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetBookingOutput_2024_08_13'
components:
schemas:
GetBookingOutput_2024_08_13:
type: object
properties:
status:
type: string
example: success
enum:
- success
- error
data:
oneOf:
- $ref: '#/components/schemas/BookingOutput_2024_08_13'
- $ref: '#/components/schemas/RecurringBookingOutput_2024_08_13'
- type: array
items:
$ref: '#/components/schemas/RecurringBookingOutput_2024_08_13'
- $ref: '#/components/schemas/GetSeatedBookingOutput_2024_08_13'
- $ref: '#/components/schemas/GetRecurringSeatedBookingOutput_2024_08_13'
- type: array
items:
$ref: >-
#/components/schemas/GetRecurringSeatedBookingOutput_2024_08_13
description: >-
Booking data, which can be either a BookingOutput object, a
RecurringBookingOutput object, or an array of RecurringBookingOutput
objects
required:
- status
- data
BookingOutput_2024_08_13:
type: object
properties:
id:
type: number
example: 123
uid:
type: string
example: booking_uid_123
title:
type: string
example: Consultation
description:
type: string
example: Learn how to integrate scheduling into marketplace.
hosts:
type: array
```
--------------------------------
### Get a Booking Details
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking
Fetches the complete details of a booking, including information about seated attendees and custom booking fields.
```APIDOC
## GET /bookings/{bookingId}
### Description
Retrieves the details of a specific booking, including attendee information and custom fields.
### Method
GET
### Endpoint
/bookings/{bookingId}
### Parameters
#### Path Parameters
- **bookingId** (string) - Required - The unique identifier of the booking to retrieve.
### Response
#### Success Response (200)
- **bookingId** (string) - The unique identifier of the booking.
- **name** (string) - The name of the booking.
- **email** (string) - The email address associated with the booking.
- **displayEmail** (string) - A cleaned email address for display purposes.
- **timeZone** (string) - The time zone of the booking.
- **language** (string) - The primary language for the booking.
- **absent** (boolean) - Indicates if the attendee is marked as absent.
- **phoneNumber** (string) - The phone number associated with the booking.
- **seatUid** (string) - The unique identifier for the attendee's seat.
- **createdAt** (string) - The date and time when the attendee joined the seated booking.
- **bookingFieldsResponses** (object) - Booking field responses with booking field slugs as keys and user responses as values.
- **metadata** (object) - Additional metadata for the booking.
#### Response Example
```json
{
"bookingId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
"name": "John Doe",
"email": "john.doe@example.com",
"displayEmail": "john.doe@example.com",
"timeZone": "America/New_York",
"language": "en",
"absent": false,
"phoneNumber": "+1234567890",
"seatUid": "3be561a9-31f1-4b8e-aefc-9d9a085f0dd1",
"createdAt": "2024-08-13T15:30:00Z",
"bookingFieldsResponses": {
"customField": "customValue"
},
"metadata": {
"key": "value"
}
}
```
```
--------------------------------
### Get a Booking
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking
Retrieves the details of a specific booking using its unique identifier.
```APIDOC
## GET /bookings/{booking_uid}
### Description
Retrieves the details of a specific booking.
### Method
GET
### Endpoint
/bookings/{booking_uid}
### Parameters
#### Path Parameters
- **booking_uid** (string) - Required - The unique identifier of the booking to retrieve.
### Response
#### Success Response (200)
- **id** (number) - The unique identifier of the booking.
- **uid** (string) - The unique identifier of the booking.
- **title** (string) - The title of the booking.
- **description** (string) - The description of the booking.
- **hosts** (array) - A list of booking hosts.
- **status** (string) - The status of the booking (cancelled, accepted, rejected, pending).
- **cancellationReason** (string) - The reason for cancellation, if applicable.
- **cancelledByEmail** (string) - The email of the person who cancelled the booking, if applicable.
- **reschedulingReason** (string) - The reason for rescheduling, if applicable.
- **rescheduledByEmail** (string) - The email of the person who rescheduled the booking, if applicable.
- **rescheduledFromUid** (string) - UID of the previous booking from which this booking was rescheduled.
- **rescheduledToUid** (string) - UID of the new booking to which this booking was rescheduled.
- **start** (string) - The start date and time of the booking.
- **end** (string) - The end date and time of the booking.
- **duration** (number) - The duration of the booking in minutes.
- **eventTypeId** (number) - Deprecated - rely on 'eventType' object containing the id instead.
- **eventType** (object) - Information about the event type.
- **location** (string) - The meeting location or URL.
- **absentHost** (boolean) - Indicates if the host is absent.
- **createdAt** (string) - The timestamp when the booking was created.
- **updatedAt** (string) - The timestamp when the booking was last updated.
- **icsUid** (string) - UID of ICS event.
- **attendees** (array) - A list of attendees for the booking.
- **guests** (array) - A list of guest email addresses.
- **bookingFieldsResponses** (object) - Booking field responses.
#### Response Example
```json
{
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"email": "host@example.com",
"firstName": "Host",
"lastName": "User",
"timezone": "UTC"
}
],
"status": "accepted",
"cancellationReason": null,
"cancelledByEmail": null,
"reschedulingReason": null,
"rescheduledByEmail": null,
"rescheduledFromUid": null,
"rescheduledToUid": null,
"start": "2024-08-13T15:30:00Z",
"end": "2024-08-13T16:30:00Z",
"duration": 60,
"eventTypeId": 50,
"eventType": {
"id": 50,
"title": "Consultation",
"slug": "consultation"
},
"location": "https://example.com/meeting",
"absentHost": false,
"createdAt": "2024-08-13T15:30:00Z",
"updatedAt": "2024-08-13T15:30:00Z",
"icsUid": "ics_uid_123",
"attendees": [
{
"email": "attendee@example.com",
"firstName": "Attendee",
"lastName": "User",
"timezone": "UTC"
}
],
"guests": [
"guest1@example.com",
"guest2@example.com"
],
"bookingFieldsResponses": {
"customField": "customValue"
}
}
```
```
--------------------------------
### Get a booking
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking
Fetches a booking using its UID. This can be a normal booking, a recurrence of a recurring booking, or a recurring booking UID which returns all recurrences. Special handling is required for seated bookings and authentication.
```APIDOC
## GET /v2/bookings/{bookingUid}
### Description
Retrieves the details of a specific booking using its unique identifier. This endpoint supports fetching individual bookings, specific recurrences of recurring bookings, or all recurrences of a recurring booking.
### Method
GET
### Endpoint
/v2/bookings/{bookingUid}
### Parameters
#### Path Parameters
- **bookingUid** (string) - Required - The unique identifier for the booking.
#### Header Parameters
- **cal-api-version** (string) - Required - Must be set to `2026-02-25`.
- **Authorization** (string) - Optional - `Bearer ` where `` is an API key, managed user access token, or OAuth access token.
- **x-cal-secret-key** (string) - Optional - For platform customers, the OAuth client secret key.
- **x-cal-client-id** (string) - Optional - For platform customers, the OAuth client ID.
### Response
#### Success Response (200)
- **status** (string) - Indicates the status of the operation ('success' or 'error').
- **data** (object|array) - Contains the booking details. This can be a single booking object, a recurring booking object, an array of recurring booking objects, or specific types for seated bookings.
### Request Example
```json
{
"example": "request body"
}
```
### Response Example
```json
{
"status": "success",
"data": {
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
// ... host details
]
}
}
```
```
--------------------------------
### Get Booking by UID
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid
Fetches a specific booking using its unique identifier. This endpoint is deprecated and users should rely on the 'location' field for meeting URLs.
```APIDOC
## GET /bookings/{uid}
### Description
Retrieves the details of a specific booking using its unique identifier.
### Method
GET
### Endpoint
/bookings/{uid}
### Parameters
#### Path Parameters
- **uid** (string) - Required - The unique identifier of the booking.
### Response
#### Success Response (200)
- **id** (number) - The unique identifier of the booking.
- **uid** (string) - The unique identifier of the booking.
- **title** (string) - The title of the booking.
- **description** (string) - The description of the booking.
- **hosts** (array) - An array of booking hosts.
- **status** (string) - The status of the booking (e.g., 'accepted', 'cancelled').
- **cancellationReason** (string) - The reason for cancellation, if applicable.
- **cancelledByEmail** (string) - The email of the user who cancelled the booking.
- **reschedulingReason** (string) - The reason for rescheduling, if applicable.
- **rescheduledByEmail** (string) - The email of the user who rescheduled the booking.
- **rescheduledFromUid** (string) - The UID of the previous booking from which this booking was rescheduled.
- **rescheduledToUid** (string) - The UID of the new booking to which this booking was rescheduled.
- **start** (string) - The start date and time of the booking.
- **end** (string) - The end date and time of the booking.
- **duration** (number) - The duration of the booking in minutes.
- **eventTypeId** (number) - Deprecated. Use 'eventType' object instead.
- **eventType** (object) - An object containing details about the event type.
- **meetingUrl** (string) - Deprecated. Use 'location' field instead.
- **location** (string) - The URL for the meeting location.
- **absentHost** (boolean) - Indicates if the host was absent.
- **createdAt** (string) - The date and time when the booking was created.
- **updatedAt** (string) - The date and time when the booking was last updated.
- **metadata** (object) - Additional metadata for the booking.
- **rating** (number) - The rating of the booking.
- **icsUid** (string) - The UID of the ICS event.
- **attendees** (array) - An array of booking attendees.
- **bookingFieldsResponses** (object) - User responses for custom booking fields.
- **recurringBookingUid** (string) - The UID of the recurring booking, if applicable.
#### Response Example
{
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"email": "host@example.com",
"name": "Host Name"
}
],
"status": "accepted",
"cancellationReason": null,
"cancelledByEmail": null,
"reschedulingReason": null,
"rescheduledByEmail": null,
"rescheduledFromUid": null,
"rescheduledToUid": null,
"start": "2024-08-13T15:30:00Z",
"end": "2024-08-13T16:30:00Z",
"duration": 60,
"eventTypeId": 50,
"eventType": {
"id": 50,
"name": "Consultation"
},
"meetingUrl": "https://example.com/recurring-meeting",
"location": "https://example.com/meeting",
"absentHost": true,
"createdAt": "2024-08-13T15:30:00Z",
"updatedAt": "2024-08-13T15:30:00Z",
"metadata": {
"key": "value"
},
"rating": 4,
"icsUid": "ics_uid_123",
"attendees": [
{
"email": "attendee@example.com",
"name": "Attendee Name"
}
],
"bookingFieldsResponses": {
"customField": "customValue"
},
"recurringBookingUid": "recurring_uid_987"
}
```
--------------------------------
### Get Booking by UID
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid
Fetches a specific booking using its unique identifier (UID). This endpoint returns detailed information about the booking, including its status, scheduled times, event type, location, and any associated custom fields.
```APIDOC
## GET /bookings/{uid}
### Description
Retrieves the details of a specific booking using its unique identifier.
### Method
GET
### Endpoint
/bookings/{uid}
### Parameters
#### Path Parameters
- **uid** (string) - Required - The unique identifier of the booking to retrieve.
### Response
#### Success Response (200)
- **id** (number) - The internal ID of the booking.
- **uid** (string) - The unique identifier of the booking.
- **title** (string) - The title of the booking.
- **description** (string) - The description of the booking.
- **hosts** (array) - Information about the hosts of the booking.
- **status** (string) - The current status of the booking (e.g., 'accepted', 'cancelled').
- **cancellationReason** (string) - The reason for cancellation, if applicable.
- **cancelledByEmail** (string) - The email of the user who cancelled the booking, if applicable.
- **reschedulingReason** (string) - The reason for rescheduling, if applicable.
- **rescheduledByEmail** (type) - The email of the user who rescheduled the booking, if applicable.
- **rescheduledFromUid** (string) - The UID of the previous booking from which this booking was rescheduled.
- **rescheduledToUid** (string) - The UID of the new booking to which this booking was rescheduled.
- **start** (string) - The start date and time of the booking in ISO 8601 format.
- **end** (string) - The end date and time of the booking in ISO 8601 format.
- **duration** (number) - The duration of the booking in minutes.
- **eventTypeId** (number) - Deprecated. Use 'eventType' instead.
- **eventType** (object) - Details about the type of event.
- **meetingUrl** (string) - Deprecated. Use 'location' instead.
- **location** (string) - The location of the meeting (e.g., a video conference URL).
- **absentHost** (boolean) - Indicates if the host was absent.
- **createdAt** (string) - The timestamp when the booking was created.
- **updatedAt** (string) - The timestamp when the booking was last updated.
- **metadata** (object) - Additional metadata associated with the booking.
- **rating** (number) - The rating given for the booking, if applicable.
- **icsUid** (string) - The UID of the ICS event.
- **attendees** (array) - A list of attendees for the booking.
- **guests** (array) - A list of guest email addresses.
- **bookingFieldsResponses** (object) - User responses to custom booking fields.
#### Response Example
{
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"email": "host@example.com",
"name": "Host Name"
}
],
"status": "accepted",
"cancellationReason": null,
"cancelledByEmail": null,
"reschedulingReason": null,
"rescheduledByEmail": null,
"rescheduledFromUid": null,
"rescheduledToUid": null,
"start": "2024-08-13T15:30:00Z",
"end": "2024-08-13T16:30:00Z",
"duration": 60,
"eventTypeId": 50,
"eventType": {
"id": 50,
"title": "Consultation",
"duration": 60
},
"meetingUrl": null,
"location": "https://example.com/meeting",
"absentHost": false,
"createdAt": "2024-08-13T15:30:00Z",
"updatedAt": "2024-08-13T15:30:00Z",
"metadata": {
"key": "value"
},
"rating": 4,
"icsUid": "ics_uid_123",
"attendees": [
{
"email": "attendee@example.com",
"name": "Attendee Name"
}
],
"guests": [
"guest1@example.com",
"guest2@example.com"
],
"bookingFieldsResponses": {
"customField": "customValue"
}
}
```
--------------------------------
### Get Booking by Seat UID
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid
Retrieves the details of a booking using its associated seat UID. This endpoint is useful for identifying and accessing booking information when only the seat identifier is known.
```APIDOC
## GET /bookings/{seatUid}
### Description
Retrieves the details of a booking using its associated seat UID. This endpoint is useful for identifying and accessing booking information when only the seat identifier is known.
### Method
GET
### Endpoint
/bookings/{seatUid}
### Parameters
#### Path Parameters
- **seatUid** (string) - Required - The unique identifier for the seat within a booking.
### Response
#### Success Response (200)
- **name** (string) - The name of the attendee.
- **email** (string) - The email address of the attendee.
- **displayEmail** (string) - Clean email for display purposes.
- **timeZone** (string) - The time zone of the attendee (e.g., 'America/New_York').
- **language** (string) - The preferred language for communication (e.g., 'en').
- **absent** (boolean) - Indicates if the attendee is marked as absent.
- **phoneNumber** (string) - The phone number of the attendee.
- **seatUid** (string) - The unique identifier for the seat.
- **createdAt** (string) - The date and time when the attendee joined the seated booking (ISO 8601 format).
- **bookingFieldsResponses** (object) - Booking field responses consisting of an object with booking field slug as keys and user response as values.
- **metadata** (object) - Additional metadata associated with the booking.
#### Response Example
{
"name": "John Doe",
"email": "john@example.com",
"displayEmail": "john@example.com",
"timeZone": "America/New_York",
"language": "en",
"absent": false,
"phoneNumber": "+1234567890",
"seatUid": "3be561a9-31f1-4b8e-aefc-9d9a085f0dd1",
"createdAt": "2024-08-13T15:30:00Z",
"bookingFieldsResponses": {
"customField": "customValue"
},
"metadata": {
"key": "value"
}
}
```
--------------------------------
### Get a booking by seat UID
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid
Fetches a seated booking using its seat reference UID. This is useful for retrieving complete booking details when only the seatUid is known. Special considerations apply for fetching attendees based on event type settings and authentication.
```APIDOC
## GET /v2/bookings/by-seat/{seatUid}
### Description
Get a seated booking by its seat reference UID. This is useful when you have a seatUid from a seated booking and want to retrieve the full booking details.
If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner.
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
### Method
GET
### Endpoint
/v2/bookings/by-seat/{seatUid}
### Parameters
#### Header Parameters
- **cal-api-version** (string) - Required - Must be set to 2026-02-25.
- **Authorization** (string) - Optional - value must be `Bearer ` where `` is api key prefixed with cal_, managed user access token, or OAuth access token
- **x-cal-secret-key** (string) - Optional - For platform customers - OAuth client secret key
- **x-cal-client-id** (string) - Optional - For platform customers - OAuth client ID
#### Path Parameters
- **seatUid** (string) - Required - The unique identifier for the seated booking.
### Responses
#### Success Response (200)
- **status** (string) - Indicates the status of the operation ('success' or 'error').
- **data** (object | array) - Contains the booking details. This can be a BookingOutput object, a RecurringBookingOutput object, an array of RecurringBookingOutput objects, a GetSeatedBookingOutput object, a GetRecurringSeatedBookingOutput object, or an array of GetRecurringSeatedBookingOutput objects.
#### Example Response (200)
```json
{
"status": "success",
"data": {
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"id": 1,
"email": "host@example.com",
"name": "Host Name"
}
],
"status": "accepted"
}
}
```
```
--------------------------------
### GetSeatedBookingOutput
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking
Retrieves the details of a specific booking, including attendee information, meeting links, and timestamps. This is the primary method for fetching booking data.
```APIDOC
## GET /bookings/{bookingId}
### Description
Retrieves the details of a specific booking.
### Method
GET
### Endpoint
/bookings/{bookingId}
### Parameters
#### Path Parameters
- **bookingId** (string) - Required - The unique identifier of the booking to retrieve.
### Response
#### Success Response (200)
- **id** (number) - The unique identifier of the booking.
- **uid** (string) - The unique identifier of the booking.
- **title** (string) - The title of the booking.
- **description** (string) - The description of the booking.
- **hosts** (array) - A list of hosts for the booking.
- **status** (string) - The status of the booking (e.g., 'accepted', 'cancelled').
- **cancellationReason** (string) - The reason for cancellation, if applicable.
- **cancelledByEmail** (string) - The email of the user who cancelled the booking, if applicable.
- **reschedulingReason** (string) - The reason for rescheduling, if applicable.
- **rescheduledByEmail** (string) - The email of the user who rescheduled the booking, if applicable.
- **rescheduledFromUid** (string) - The UID of the previous booking from which this booking was rescheduled.
- **rescheduledToUid** (string) - The UID of the new booking to which this booking was rescheduled.
- **start** (string) - The start date and time of the booking.
- **end** (string) - The end date and time of the booking.
- **duration** (number) - The duration of the booking in minutes.
- **eventType** (object) - An object containing details about the event type.
- **location** (string) - The meeting location or URL.
- **absentHost** (boolean) - Indicates if the host was absent.
- **createdAt** (string) - The date and time when the booking was created.
- **updatedAt** (string) - The date and time when the booking was last updated.
- **metadata** (object) - Additional metadata associated with the booking.
- **rating** (number) - The rating of the booking.
- **icsUid** (string) - The UID of the ICS event.
- **attendees** (array) - A list of attendees for the booking.
- **guests** (array) - A list of guest email addresses.
- **bookingFieldsResponses** (object) - User responses to booking fields.
- **recurringBookingUid** (string) - The UID of the recurring booking, if applicable.
#### Response Example
```json
{
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"email": "host@example.com",
"name": "Host Name"
}
],
"status": "accepted",
"cancellationReason": null,
"cancelledByEmail": null,
"reschedulingReason": null,
"rescheduledByEmail": null,
"rescheduledFromUid": null,
"rescheduledToUid": null,
"start": "2024-08-13T15:30:00Z",
"end": "2024-08-13T16:30:00Z",
"duration": 60,
"eventType": {
"id": 50,
"name": "Default Event Type"
},
"meetingUrl": null,
"location": "https://example.com/meeting",
"absentHost": true,
"createdAt": "2024-08-13T15:30:00Z",
"updatedAt": "2024-08-13T15:30:00Z",
"metadata": {
"key": "value"
},
"rating": 4,
"icsUid": "ics_uid_123",
"attendees": [
{
"email": "attendee@example.com",
"name": "Attendee Name"
}
],
"guests": [
"guest1@example.com",
"guest2@example.com"
],
"bookingFieldsResponses": {
"customField": "customValue"
},
"recurringBookingUid": "recurring_uid_987"
}
```
```
--------------------------------
### GetRecurringSeatedBookingOutput
Source: https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid
Retrieves the details of a recurring seated booking by its UID.
```APIDOC
## GET /bookings/{booking_uid}
### Description
Retrieves the details of a specific recurring seated booking using its unique identifier.
### Method
GET
### Endpoint
/bookings/{booking_uid}
### Parameters
#### Path Parameters
- **booking_uid** (string) - Required - The unique identifier of the booking.
### Response
#### Success Response (200)
- **id** (number) - The unique identifier of the booking.
- **uid** (string) - The unique identifier of the booking.
- **title** (string) - The title of the booking.
- **description** (string) - The description of the booking.
- **hosts** (array) - An array of booking hosts.
- **status** (string) - The status of the booking (e.g., 'cancelled', 'accepted', 'rejected', 'pending').
- **cancellationReason** (string) - The reason for cancellation, if applicable.
- **cancelledByEmail** (string) - The email of the person who cancelled the booking.
- **reschedulingReason** (string) - The reason for rescheduling, if applicable.
- **rescheduledByEmail** (string) - The email of the person who rescheduled the booking.
- **rescheduledFromUid** (string) - UID of the previous booking from which this booking was rescheduled.
- **rescheduledToUid** (string) - UID of the new booking to which this booking was rescheduled.
- **start** (string) - The start date and time of the booking.
- **end** (string) - The end date and time of the booking.
- **duration** (number) - The duration of the booking in minutes.
- **eventTypeId** (number) - Deprecated. Use 'eventType' object instead.
- **eventType** (object) - The event type details.
- **meetingUrl** (string) - Deprecated. Use 'location' field instead.
- **location** (string) - The meeting URL or location.
- **absentHost** (boolean) - Indicates if the host was absent.
- **createdAt** (string) - The timestamp when the booking was created.
- **updatedAt** (string) - The timestamp when the booking was last updated.
- **metadata** (object) - Additional metadata for the booking.
- **rating** (number) - The rating of the booking.
- **icsUid** (string) - The UID of the ICS event.
- **attendees** (array) - An array of attendees for the booking.
- **recurringBookingUid** (string) - The UID of the recurring booking.
#### Response Example
```json
{
"id": 123,
"uid": "booking_uid_123",
"title": "Consultation",
"description": "Learn how to integrate scheduling into marketplace.",
"hosts": [
{
"id": 1,
"name": "Jane Doe",
"email": "jane100@example.com",
"displayEmail": "jane100@example.com",
"username": "jane100",
"timeZone": "America/Los_Angeles"
}
],
"status": "accepted",
"cancellationReason": "User requested cancellation",
"cancelledByEmail": "canceller@example.com",
"reschedulingReason": "User rescheduled the event",
"rescheduledByEmail": "rescheduler@example.com",
"rescheduledFromUid": "previous_uid_123",
"rescheduledToUid": "new_uid_456",
"start": "2024-08-13T15:30:00Z",
"end": "2024-08-13T16:30:00Z",
"duration": 60,
"eventTypeId": 50,
"eventType": {
"id": 1,
"slug": "some-event"
},
"meetingUrl": "https://example.com/recurring-meeting",
"location": "https://example.com/meeting",
"absentHost": true,
"createdAt": "2024-08-13T15:30:00Z",
"updatedAt": "2024-08-13T15:30:00Z",
"metadata": {
"key": "value"
},
"rating": 4,
"icsUid": "ics_uid_123",
"attendees": [
{
"name": "John Doe",
"email": "john@example.com",
"displayEmail": "john@example.com",
"timeZone": "America/New_York",
"language": "en"
}
],
"recurringBookingUid": "recurring_uid_987"
}
```
```
=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.