List a team's Events (cursor pagination)

Returns every Event the team owns, including ones the authenticated user neither hosts nor co-hosts. The user must be an accepted member of the team, or of its parent organization. PBAC permission: calEvent.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. Ordered by start time, newest first when status is omitted.

Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. pagination.hasMore is false and pagination.nextCursor is null on the last page.

Must pass cal-api-version: 2026-05-01 (or later). Older versions use take/skip offset pagination.

Events are fixed-date RSVP pages served at cal.com/; they are not event types (bookable meeting templates) or calendar events. If accessed using an OAuth access token, the TEAM_EVENT_READ scope is required.

GET /v2/teams/{teamId}/events

List a team's Events (cursor pagination)

cURL

curl --request GET \
  --url https://api.cal.com/v2/teams/{teamId}/events \
  --header 'Authorization: <authorization>' \
  --header 'cal-api-version: <cal-api-version>'

200

{
  "status": "success",
  "data": [
    {
      "uuid": "<string>",
      "slug": "<string>",
      "title": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "checkInOpensAt": "2023-11-07T05:31:56Z",
      "checkInClosesAt": "2023-11-07T05:31:56Z",
      "timeZone": "<string>",
      "visibility": "PUBLIC",
      "category": "meetup",
      "hidden": true,
      "status": "draft",
      "locations": [
        {
          "id": "<string>",
          "price": 2500,
          "currency": "usd",
          "type": "address",
          "address": "123 Event Street",
          "label": "<string>",
          "capacity": 50000.5
        }
      ],
      "requiresApproval": true,
      "registrationOpensAt": "2023-11-07T05:31:56Z",
      "registrationClosesAt": "2023-11-07T05:31:56Z",
      "waitlistEnabled": true,
      "showOrganizerEmail": true,
      "guestList": "hidden",
      "showPresentedBy": true,
      "liveStreams": [
        {
          "url": "<string>"
        }
      ],
      "registrationFields": [
        {
          "field": "name",
          "slug": "name",
          "variant": "fullName",
          "disableOnPrefill": true,
          "label": "<string>",
          "placeholder": "<string>"
        }
      ],
      "hosts": [
        {
          "userId": 123,
          "name": "Jane Doe",
          "username": "jane",
          "avatarUrl": "<string>"
        }
      ],
      "paymentsEnabled": true,
      "description": "<string>",
      "publishedAt": "2023-11-07T05:31:56Z",
      "cancelledAt": "2023-11-07T05:31:56Z",
      "coverImageUrl": "<string>",
      "paymentTimeoutMinutes": 123,
      "confirmedCount": 123,
      "theme": "light",
      "poster": {
        "layout": "date",
        "palette": {
          "background": "#0b1c2c",
          "foreground": "#a5d8ff",
          "accent": "#1f6feb"
        },
        "headline": "<string>",
        "seed": 123
      },
      "lineup": {
        "title": "<string>",
        "people": [
          {
            "name": "<string>",
            "role": "<string>",
            "avatarUrl": "<string>",
            "links": [
              {
                "url": "<string>"
              }
            ],
            "media": [
              {
                "url": "<string>",
                "label": "<string>"
              }
            ]
          }
        ]
      },
      "schedule": [
        {
          "startTime": "2023-11-07T05:31:56Z",
          "endTime": "2023-11-07T05:31:56Z",
          "timeLabel": "<string>",
          "content": "<string>",
          "people": [
            {
              "name": "<string>",
              "role": "<string>",
              "avatarUrl": "<string>",
              "links": [
                {
                  "url": "<string>"
                }
              ]
            }
          ]
        }
      ],
      "background": {
        "effect": "aurora",
        "colors": [
          "<string>"
        ]
      },
      "capacity": 100,
      "price": 1500,
      "currency": "usd",
      "cancellationReason": "<string>",
      "userId": 123,
      "teamId": 123
    }
  ],
  "pagination": {
    "nextCursor": "eyJ2IjoyLCJzdGFydFRpbWUiOiIyMDMwLTAxLTAxVDAwOjAwOjAwLjAwMFoiLCJldmVudFR5cGVVdWlkIjoiMDE4ZjRjMmUtM2YxYS03YWJjLTlkZWYtMDEyMzQ1Njc4OWFiIn0",
    "hasMore": true
  }
}

Headers

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

Must be set to 2026-05-01 (or a later API version) for cursor pagination.

Example:

"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

Path Parameters

teamId · string number · required

The team's uuid (preferred), its short-uuid (Flickr Base58) form, or its numeric id.

Query Parameters

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:

"eyJ2IjoyLCJzdGFydFRpbWUiOiIyMDMwLTAxLTAxVDAwOjAwOjAwLjAwMFoiLCJldmVudFR5cGVVdWlkIjoiMDE4ZjRjMmUtM2YxYS03YWJjLTlkZWYtMDEyMzQ1Njc4OWFiIn0"

limit · number · default: 50

Maximum number of Events to return.

Required range: 1 <= x <= 250

Example:

25

slug · string

Filter by the event's public page slug (cal.com/{slug}).

Example:

"team-offsite"

status · enum<string>

Filter events by lifecycle status. draft: not published and not cancelled, ordered soonest first. upcoming: published and not yet ended, or cancelled but not yet started, ordered soonest first. past: everything else, ordered latest first. Omit to return all statuses, newest first. When provided, pagination.nextCursor encodes the status — cursors from one status value cannot be used with another and return 400.

Available options: draft, upcoming, past

Example:

"upcoming"

Response

200

application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes