Skip to main content
GET
/
v2
/
bookings
Get all bookings
curl --request GET \
  --url https://api.cal.com/v2/bookings \
  --header 'Authorization: <authorization>' \
  --header 'cal-api-version: <cal-api-version>'
{
  "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": "jane100@example.com",
          "displayEmail": "jane100@example.com",
          "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": "john@example.com",
          "displayEmail": "john@example.com",
          "timeZone": "America/New_York",
          "absent": false,
          "language": "en",
          "phoneNumber": "+1234567890"
        }
      ],
      "bookingFieldsResponses": {
        "customField": "customValue"
      },
      "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",
      "meetingUrl": "https://example.com/recurring-meeting",
      "metadata": {
        "key": "value"
      },
      "rating": 4,
      "icsUid": "ics_uid_123",
      "guests": [
        "guest1@example.com",
        "guest2@example.com"
      ]
    }
  ],
  "pagination": {
    "nextCursor": "eyJ2IjoxLCJzb3J0VXVpZCI6IjAxOGY0YzJlLTNmMWEtN2FiYy05ZGVmLTAxMjM0NTY3ODlhYiJ9",
    "hasMore": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://cal.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
cal-api-version
string
default:2026-05-01
required

Must be set to 2026-05-01.

​
Authorization
string
required

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

Query Parameters

​
status
enum<string>[]

Filter bookings by status. Accepts at most one value per call (e.g. ?status=upcoming). Omit to walk all statuses ordered by Booking.uuid DESC. To list bookings across multiple statuses, issue parallel requests, one per status.

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

"?status=upcoming"

​
attendeeEmail
string

Filter bookings by the attendee's email address.

Example:

"example@domain.com"

​
attendeeName
string

Filter bookings by the attendee's name.

Example:

"John Doe"

​
bookingUid
string

Filter bookings by the booking Uid.

Example:

"2NtaeaVcKfpmSZ4CthFdfk"

​
eventTypeIds
string

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

Example:

"?eventTypeIds=100,200"

​
eventTypeId
string

Filter bookings by event type id belonging to the user.

Example:

"?eventTypeId=100"

​
teamsIds
string

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

Example:

"?teamIds=50,60"

​
teamId
string

Filter bookings by team id that user is part of

Example:

"?teamId=50"

​
afterStart
string

Filter bookings with start after this date string.

Example:

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

​
beforeEnd
string

Filter bookings with end before this date string.

Example:

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

​
afterCreatedAt
string

Filter bookings that have been created after this date string.

Example:

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

​
beforeCreatedAt
string

Filter bookings that have been created before this date string.

Example:

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

​
afterUpdatedAt
string

Filter bookings that have been updated after this date string.

Example:

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

​
beforeUpdatedAt
string

Filter bookings that have been updated before this date string.

Example:

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

​
sortStart
enum<string>

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

Available options:
asc,
desc
Example:

"?sortStart=asc OR ?sortStart=desc"

​
sortEnd
enum<string>

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

Available options:
asc,
desc
Example:

"?sortEnd=asc OR ?sortEnd=desc"

​
sortCreated
enum<string>

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

Available options:
asc,
desc
Example:

"?sortCreated=asc OR ?sortCreated=desc"

​
sortUpdatedAt
enum<string>

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

Available options:
asc,
desc
Example:

"?sortUpdated=asc OR ?sortUpdated=desc"

​
cursor
string

Opaque cursor for cursor-based pagination. Pass the pagination.nextCursor value from a previous response to fetch the next page. Omit to fetch the first page.

Example:

"eyJ2IjoxLCJzb3J0VXVpZCI6IjAxOGY0YzJlLTNmMWEtN2FiYy05ZGVmLTAxMjM0NTY3ODlhYiJ9"

​
limit
number
default:50

The number of items to return

Example:

50

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

​
pagination
object
required