Get organization team bookings

GET /v2/organizations/{orgId}/teams/{teamId}/bookings

Get organization team bookings

cURL

curl --request GET \
  --url https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/bookings

200

{
  "status": "success",
  "data": [
    {
      "id": 123,
      "uid": "booking_uid_123",
      "title": "Consultation",
      "description": "Learn how to integrate scheduling into marketplace.",
      "hosts": [
        {
          "id": 1,
          "name": "Jane Doe",
          "email": "[e-mail]",
          "username": "jane100",
          "timeZone": "America/Los_Angeles"
        }
      ],
      "status": "accepted",
      "start": "2024-08-13T15:30:00Z",
      "end": "2024-08-13T16:30:00Z",
      "duration": 60,
      "eventTypeId": 50,
      "eventType": {
        "id": 1,
        "slug": "some-event"
      },
      "location": "https://example.com/meeting",
      "absentHost": true,
      "createdAt": "2024-08-13T15:30:00Z",
      "updatedAt": "2024-08-13T15:30:00Z",
      "attendees": [
        {
          "name": "John Doe",
          "email": "[e-mail]",
          "timeZone": "America/New_York",
          "absent": false,
          "language": "en",
          "phoneNumber": "[phone]"
        }
      ],
      "bookingFieldsResponses": {
        "customField": "customValue"
      },
      "cancellationReason": "User requested cancellation",
      "cancelledByEmail": "[e-mail]",
      "reschedulingReason": "User rescheduled the event",
      "rescheduledByEmail": "[e-mail]",
      "rescheduledFromUid": "previous_uid_123",
      "rescheduledToUid": "new_uid_456",
      "meetingUrl": "https://example.com/recurring-meeting",
      "metadata": {
        "key": "value"
      },
      "rating": 4,
      "icsUid": "ics_uid_123",
      "guests": [
        "[e-mail]",
        "[e-mail]"
      ]
    }
  ],
  "pagination": {
    "totalItems": 123,
    "remainingItems": 103,
    "returnedItems": 10,
    "itemsPerPage": 10,
    "currentPage": 2,
    "totalPages": 13,
    "hasNextPage": true,
    "hasPreviousPage": true
  },
  "error": {}
}

Headers

Authorization · string

For non-platform customers - value must be Bearer <token> where <token> is api key prefixed with cal_

x-cal-secret-key · string

For platform customers - OAuth client secret key

x-cal-client-id · string

For platform customers - OAuth client ID

Path Parameters

teamId · number · required

orgId · number · required

Query Parameters

status · enum<string>[]

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

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

attendeeEmail · string

Filter bookings by the attendee's email address.

attendeeName · string

Filter bookings by the attendee's name.

bookingUid · string

Filter bookings by the booking Uid.

eventTypeIds · string

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

eventTypeId · string

Filter bookings by event type id belonging to the team.

afterStart · string

Filter bookings with start after this date string.

beforeEnd · string

Filter bookings with end before this date string.

sortStart · enum<string>

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

Available options: asc, desc

sortEnd · enum<string>

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

Available options: asc, desc

sortCreated · enum<string>

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

Available options: asc, desc

take · number

The number of items to return

Required range: 1 <= x <= 250

skip · number

The number of items to skip

Required range: x >= 0

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object[] · required

Array of booking data, which can contain either BookingOutput objects or RecurringBookingOutput objects

Option 1

Option 2

Option 3

Option 4

Show child attributes

pagination · object · required

Show child attributes

error · object