---
title: "Get all bookings"
method: GET
path: "/v2/bookings"
tags: ["Bookings"]
---

# Get all bookings

`GET /v2/bookings`

<Note>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.</Note>

## Query parameters

- `status` string[]
- `attendeeEmail` string
- `attendeeName` string
- `bookingUid` string
- `eventTypeIds` string
- `eventTypeId` string
- `teamsIds` string
- `teamId` string
- `afterStart` string
- `beforeEnd` string
- `afterCreatedAt` string
- `beforeCreatedAt` string
- `afterUpdatedAt` string
- `beforeUpdatedAt` string
- `sortStart` 'asc' | 'desc'
- `sortEnd` 'asc' | 'desc'
- `sortCreated` 'asc' | 'desc'
- `sortUpdatedAt` 'asc' | 'desc'
- `take` number
- `skip` number

## Headers

- `cal-api-version` string, required
- `Authorization` string, required

## Response `200`

- GetBookingsOutput20240813
  - `status` 'success' | 'error', required
  - `data` union[], required — Array of booking data, which can contain either BookingOutput objects or RecurringBookingOutput objects
    - union
      - BookingOutput20240813
        - `id` number, required
        - `uid` string, required
        - `title` string, required
        - `description` string, required
        - `hosts` BookingHost[], required
          - `id` number, required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `username` string, required
          - `timeZone` string, required
        - `status` 'cancelled' | 'accepted' | 'rejected' | 'pending', required
        - `cancellationReason` string
        - `cancelledByEmail` string
        - `reschedulingReason` string
        - `rescheduledByEmail` string
        - `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, required
        - `end` string, required
        - `duration` number, required
        - `eventTypeId` number, required — Deprecated - rely on 'eventType' object containing the id instead.
        - `eventType` EventType, required
          - `id` number, required
          - `slug` string, required
        - `meetingUrl` string — Deprecated - rely on 'location' field instead.
        - `location` string, required
        - `absentHost` boolean, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `metadata` object
        - `rating` number
        - `icsUid` string — UID of ICS event.
        - `attendees` BookingAttendee[], required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `timeZone` string, required
          - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn'
          - `absent` boolean, required
          - `phoneNumber` string
        - `guests` string[]
        - `bookingFieldsResponses` object, required — Booking field responses consisting of an object with booking field slug as keys and user response as values.
      - RecurringBookingOutput20240813
        - `id` number, required
        - `uid` string, required
        - `title` string, required
        - `description` string, required
        - `hosts` BookingHost[], required
          - `id` number, required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `username` string, required
          - `timeZone` string, required
        - `status` 'cancelled' | 'accepted' | 'rejected' | 'pending', required
        - `cancellationReason` string
        - `cancelledByEmail` string
        - `reschedulingReason` string
        - `rescheduledByEmail` string
        - `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, required
        - `end` string, required
        - `duration` number, required
        - `eventTypeId` number, required — Deprecated - rely on 'eventType' object containing the id instead.
        - `eventType` EventType, required
          - `id` number, required
          - `slug` string, required
        - `meetingUrl` string — Deprecated - rely on 'location' field instead.
        - `location` string, required
        - `absentHost` boolean, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `metadata` object
        - `rating` number
        - `icsUid` string — UID of ICS event.
        - `attendees` BookingAttendee[], required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `timeZone` string, required
          - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn'
          - `absent` boolean, required
          - `phoneNumber` string
        - `guests` string[]
        - `bookingFieldsResponses` object, required — Booking field responses consisting of an object with booking field slug as keys and user response as values.
        - `recurringBookingUid` string, required
      - GetSeatedBookingOutput20240813
        - `id` number, required
        - `uid` string, required
        - `title` string, required
        - `description` string, required
        - `hosts` BookingHost[], required
          - `id` number, required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `username` string, required
          - `timeZone` string, required
        - `status` 'cancelled' | 'accepted' | 'rejected' | 'pending', required
        - `cancellationReason` string
        - `cancelledByEmail` string
        - `reschedulingReason` string
        - `rescheduledByEmail` string
        - `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, required
        - `end` string, required
        - `duration` number, required
        - `eventTypeId` number, required — Deprecated - rely on 'eventType' object containing the id instead.
        - `eventType` EventType, required
          - `id` number, required
          - `slug` string, required
        - `meetingUrl` string — Deprecated - rely on 'location' field instead.
        - `location` string, required
        - `absentHost` boolean, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `metadata` object
        - `rating` number
        - `icsUid` string — UID of ICS event.
        - `attendees` SeatedAttendee[], required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `timeZone` string, required
          - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn'
          - `absent` boolean, required
          - `phoneNumber` string
          - `seatUid` string, required
          - `bookingFieldsResponses` object, required — Booking field responses consisting of an object with booking field slug as keys and user response as values.
          - `metadata` object
      - GetRecurringSeatedBookingOutput20240813
        - `id` number, required
        - `uid` string, required
        - `title` string, required
        - `description` string, required
        - `hosts` BookingHost[], required
          - `id` number, required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `username` string, required
          - `timeZone` string, required
        - `status` 'cancelled' | 'accepted' | 'rejected' | 'pending', required
        - `cancellationReason` string
        - `cancelledByEmail` string
        - `reschedulingReason` string
        - `rescheduledByEmail` string
        - `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, required
        - `end` string, required
        - `duration` number, required
        - `eventTypeId` number, required — Deprecated - rely on 'eventType' object containing the id instead.
        - `eventType` EventType, required
          - `id` number, required
          - `slug` string, required
        - `meetingUrl` string — Deprecated - rely on 'location' field instead.
        - `location` string, required
        - `absentHost` boolean, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `metadata` object
        - `rating` number
        - `icsUid` string — UID of ICS event.
        - `attendees` SeatedAttendee[], required
          - `name` string, required
          - `email` string, required
          - `displayEmail` string, required — Clean email for display purposes
          - `timeZone` string, required
          - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn'
          - `absent` boolean, required
          - `phoneNumber` string
          - `seatUid` string, required
          - `bookingFieldsResponses` object, required — Booking field responses consisting of an object with booking field slug as keys and user response as values.
          - `metadata` object
        - `recurringBookingUid` string, required
  - `pagination` PaginationMetaDto, required
    - `totalItems` number, required — The total number of items available across all pages, matching the query criteria.
    - `remainingItems` number, required — The number of items remaining to be fetched *after* the current page. Calculated as: `totalItems - (skip + itemsPerPage)`.
    - `returnedItems` number, required — The number of items returned in the current page.
    - `itemsPerPage` number, required — The maximum number of items requested per page.
    - `currentPage` number, required — The current page number being returned.
    - `totalPages` number, required — The total number of pages available.
    - `hasNextPage` boolean, required — Indicates if there is a subsequent page available after the current one.
    - `hasPreviousPage` boolean, required — Indicates if there is a preceding page available before the current one.
  - `error` object

---

[API](https://skmtc.net/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.net/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/versions/16de9d3eb7b3/schema)