Skip to main content
GET
List a team's Events (cursor pagination)

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
number
required

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"

Response

status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
object[]
required
pagination
object
required