Sign in
Orgs / Users / Bookings

Get all bookings for an organization user

get/v2/organizations/{orgId}/users/{userId}/bookings

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

orgIdnumber required
userIdnumber required

Query parameters

statusstring[]

Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.

attendeeEmailstring
Example:example@domain.com

Filter bookings by the attendee's email address.

attendeeNamestring
Example:John Doe

Filter bookings by the attendee's name.

bookingUidstring
Example:2NtaeaVcKfpmSZ4CthFdfk

Filter bookings by the booking Uid.

eventTypeIdsstring
Example:?eventTypeIds=100,200

Filter bookings by event type ids belonging to the user. Event type ids must be separated by a comma.

eventTypeIdstring
Example:?eventTypeId=100

Filter bookings by event type id belonging to the user.

teamsIdsstring
Example:?teamIds=50,60

Filter bookings by team ids that user is part of. Team ids must be separated by a comma.

teamIdstring
Example:?teamId=50

Filter bookings by team id that user is part of

afterStartstring
Example:?afterStart=2025-03-07T10:00:00.000Z

Filter bookings with start after this date string.

beforeEndstring
Example:?beforeEnd=2025-03-07T11:00:00.000Z

Filter bookings with end before this date string.

afterCreatedAtstring
Example:?afterCreatedAt=2025-03-07T10:00:00.000Z

Filter bookings that have been created after this date string.

beforeCreatedAtstring
Example:?beforeCreatedAt=2025-03-14T11:00:00.000Z

Filter bookings that have been created before this date string.

afterUpdatedAtstring
Example:?afterUpdatedAt=2025-03-07T10:00:00.000Z

Filter bookings that have been updated after this date string.

beforeUpdatedAtstring
Example:?beforeUpdatedAt=2025-03-14T11:00:00.000Z

Filter bookings that have been updated before this date string.

sortStart'asc' | 'desc'
Example:?sortStart=asc OR ?sortStart=desc

Sort results by their start time in ascending or descending order.

sortEnd'asc' | 'desc'
Example:?sortEnd=asc OR ?sortEnd=desc

Sort results by their end time in ascending or descending order.

sortCreated'asc' | 'desc'
Example:?sortCreated=asc OR ?sortCreated=desc

Sort results by their creation time (when booking was made) in ascending or descending order.

sortUpdatedAt'asc' | 'desc'
Example:?sortUpdated=asc OR ?sortUpdated=desc

Sort results by their updated time (for example when booking status changes) in ascending or descending order.

takenumber
Example:10

The number of items to return

skipnumber

The number of items to skip

Headers

Authorizationstring

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

x-cal-secret-keystring

For platform customers - OAuth client secret key

x-cal-client-idstring

For platform customers - OAuth client ID

Changes

No recorded changes to this operation across all 1 revision of this API.