Get organization team bookings

GET

organizations

{orgId}

bookings

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

{
  "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": "[email protected]",
          "username": "jane100",
          "timeZone": "America/Los_Angeles"
        }
      ],
      "status": "accepted",
      "cancellationReason": "User requested cancellation",
      "cancelledByEmail": "[email protected]",
      "reschedulingReason": "User rescheduled the event",
      "rescheduledByEmail": "[email protected]",
      "rescheduledFromUid": "previous_uid_123",
      "start": "2024-08-13T15:30:00Z",
      "end": "2024-08-13T16:30:00Z",
      "duration": 60,
      "eventTypeId": 50,
      "eventType": {
        "id": 1,
        "slug": "some-event"
      },
      "meetingUrl": "https://example.com/recurring-meeting",
      "location": "https://example.com/meeting",
      "absentHost": true,
      "createdAt": "2024-08-13T15:30:00Z",
      "updatedAt": "2024-08-13T15:30:00Z",
      "metadata": {
        "key": "value"
      },
      "rating": 4,
      "icsUid": "ics_uid_123",
      "attendees": [
        {
          "name": "John Doe",
          "email": "[email protected]",
          "timeZone": "America/New_York",
          "phoneNumber": "+919876543210",
          "language": "it"
        }
      ],
      "guests": [
        "[email protected]",
        "[email protected]"
      ],
      "bookingFieldsResponses": {
        "customField": "customValue"
      }
    }
  ],
  "error": {}
}

Path Parameters

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.

eventTypeIds

string

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

eventTypeId

string

Filter bookings by event type id belonging to the user.

teamsIds

string

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

teamId

string

Filter bookings by team id that user is part of

afterStart

string

Filter bookings with start after this date string.

beforeEnd

string

Filter bookings with end before this date string.

afterCreatedAt

string

Filter bookings that have been created after this date string.

beforeCreatedAt

string

Filter bookings that have been created before this date string.

afterUpdatedAt

string

Filter bookings that have been updated after this date string.

beforeUpdatedAt

string

Filter bookings that have been updated 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

sortUpdatedAt

enum<string>

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

Available options:

asc,

desc

take

number

The number of items to return

skip

number

The number of items to skip

userIds

string

Filter bookings by ids of users within your organization.

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

data.id

number

required

Example:

123

data.uid

string

required

Example:

"booking_uid_123"

data.title

string

required

Example:

"Consultation"

data.description

string

required

Example:

"Learn how to integrate scheduling into marketplace."

data.hosts

object[]

required

data.status

enum<string>

required

Available options:

cancelled,

accepted,

rejected,

pending

Example:

"accepted"

data.start

string

required

Example:

"2024-08-13T15:30:00Z"

data.end

string

required

Example:

"2024-08-13T16:30:00Z"

data.duration

number

required

Example:

60

data.eventTypeId

number

required

deprecated

Deprecated - rely on 'eventType' object containing the id instead.

Example:

50

data.eventType

object

required

data.location

string

required

Example:

"https://example.com/meeting"

data.absentHost

boolean

required

Example:

true

data.createdAt

string

required

Example:

"2024-08-13T15:30:00Z"

data.updatedAt

string

required

Example:

"2024-08-13T15:30:00Z"

data.attendees

object[]

required

data.bookingFieldsResponses

object

required

Booking field responses consisting of an object with booking field slug as keys and user response as values.

Example:

{ "customField": "customValue" }

data.cancellationReason

string

Example:

"User requested cancellation"

data.cancelledByEmail

string

Example:

"[email protected]"

data.reschedulingReason

string

Example:

"User rescheduled the event"

data.rescheduledByEmail

string

Example:

"[email protected]"

data.rescheduledFromUid

string

Example:

"previous_uid_123"

data.meetingUrl

string

deprecated

Deprecated - rely on 'location' field instead.

Example:

"https://example.com/recurring-meeting"

data.metadata

object

Example:

{ "key": "value" }

data.rating

number

Example:

4

data.icsUid

string

UID of ICS event.

Example:

"ics_uid_123"

data.guests

string[]

Example:

["[email protected]", "[email protected]"]

error

object

Was this page helpful?

Suggest edits Raise issue

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

{
  "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": "[email protected]",
          "username": "jane100",
          "timeZone": "America/Los_Angeles"
        }
      ],
      "status": "accepted",
      "cancellationReason": "User requested cancellation",
      "cancelledByEmail": "[email protected]",
      "reschedulingReason": "User rescheduled the event",
      "rescheduledByEmail": "[email protected]",
      "rescheduledFromUid": "previous_uid_123",
      "start": "2024-08-13T15:30:00Z",
      "end": "2024-08-13T16:30:00Z",
      "duration": 60,
      "eventTypeId": 50,
      "eventType": {
        "id": 1,
        "slug": "some-event"
      },
      "meetingUrl": "https://example.com/recurring-meeting",
      "location": "https://example.com/meeting",
      "absentHost": true,
      "createdAt": "2024-08-13T15:30:00Z",
      "updatedAt": "2024-08-13T15:30:00Z",
      "metadata": {
        "key": "value"
      },
      "rating": 4,
      "icsUid": "ics_uid_123",
      "attendees": [
        {
          "name": "John Doe",
          "email": "[email protected]",
          "timeZone": "America/New_York",
          "phoneNumber": "+919876543210",
          "language": "it"
        }
      ],
      "guests": [
        "[email protected]",
        "[email protected]"
      ],
      "bookingFieldsResponses": {
        "customField": "customValue"
      }
    }
  ],
  "error": {}
}

Getting Started

Platform / Managed Users

Platform / Webhooks

Orgs / Attributes

Orgs / Attributes / Options

Orgs / Bookings

Orgs / Delegation Credentials

Orgs / Memberships

Orgs / Orgs

Orgs / Schedules

Orgs / Teams

Orgs / Teams / Bookings

Orgs / Teams / Event Types

Orgs / Teams / Memberships

Orgs / Teams / Routing forms / Responses

Orgs / Teams / Users / Schedules

Orgs / Users

Orgs / Users / Bookings

Orgs / Users / OOO

Orgs / Users / Schedules

Orgs / Webhooks

Api Keys

Bookings

Calendars

Conferencing

Destination Calendars

Event Types

Event Types / Webhooks

Me

OAuth Clients

Organizations/Teams Conferencing

Schedules

Selected Calendars

Slots

Stripe

Teams

Teams / Event Types

Teams / Memberships

Webhooks

Path Parameters

Query Parameters

Response