Skip to main content
GET
List bookings

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Query Parameters

status
enum<string>
default:upcoming

Booking status bucket filter.

Available options:
upcoming,
recurring,
past,
cancelled,
unconfirmed
Example:

"upcoming"

teamId
integer

Filter by a single team ID. Admin/owner receives all team bookings; members receive only host/attendee bookings.

Required range: x > 1
Example:

42

eventTypeIds
integer[]

Filter by event type IDs.

Example:
attendeeEmail
string<email>

Filter by attendee email.

Example:

"booker@example.com"

attendeeName
string

Filter by attendee name.

Example:

"Jane Doe"

bookingUid
string

Filter by booking UID.

Example:

"8d579e09-83f0-4f22-bb5c-89f0ef7fd5a4"

afterStartDate
string<date-time>

Include bookings starting after this ISO timestamp.

Example:

"2026-05-01T00:00:00.000Z"

beforeEndDate
string<date-time>

Include bookings ending before this ISO timestamp.

Example:

"2026-05-31T23:59:59.000Z"

afterUpdatedDate
string<date-time>

Include bookings updated after this ISO timestamp.

Example:

"2026-05-01T00:00:00.000Z"

beforeUpdatedDate
string<date-time>

Include bookings updated before this ISO timestamp.

Example:

"2026-05-31T23:59:59.000Z"

afterCreatedDate
string<date-time>

Include bookings created after this ISO timestamp.

Example:

"2026-05-01T00:00:00.000Z"

beforeCreatedDate
string<date-time>

Include bookings created before this ISO timestamp.

Example:

"2026-05-31T23:59:59.000Z"

sortStart
enum<string>

Sort direction for booking start time.

Available options:
asc,
desc
Example:

"asc"

sortEnd
enum<string>

Sort direction for booking end time.

Available options:
asc,
desc
Example:

"desc"

sortCreated
enum<string>

Sort direction for booking creation time.

Available options:
asc,
desc
Example:

"desc"

sortUpdated
enum<string>

Sort direction for booking update time.

Available options:
asc,
desc
Example:

"desc"

page
integer
default:1

Page number (1-based).

Required range: x > 1
Example:

1

limit
integer
default:100

Maximum number of bookings returned per page.

Required range: 1 < x <= 500
Example:

100

Response

User bookings retrieved

User bookings retrieved

success
enum<boolean>
required
Available options:
true
data
object[]
required
meta
object
required
message
string