List organization team event types

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.

Hidden event types and hidden booking fields are returned only to team administrators or owners, and parent-organization administrators or owners. Other callers see public event types and visible booking fields. Authentication is optional.

GET /v2/organizations/{orgId}/teams/{teamId}/event-types

List organization team event types

cURL

curl --request GET \
  --url https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types \
  --header 'cal-api-version: <cal-api-version>'

200

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "lengthInMinutes": 60,
      "title": "Learn the secrets of masterchief!",
      "slug": "learn-the-secrets-of-masterchief",
      "description": "Discover the culinary wonders of Argentina by making the best flan ever!",
      "locations": [
        {
          "type": "address",
          "address": "123 Example St, City, Country",
          "public": true
        }
      ],
      "disableGuests": true,
      "recurrence": {
        "interval": 1,
        "occurrences": 10,
        "frequency": "yearly",
        "disabled": false
      },
      "metadata": {},
      "price": 123,
      "currency": "<string>",
      "lockTimeZoneToggleOnBookingPage": true,
      "forwardParamsSuccessRedirect": true,
      "successRedirectUrl": "<string>",
      "isInstantEvent": true,
      "scheduleId": 123,
      "hidden": true,
      "bookingRequiresAuthentication": true,
      "teamId": 123,
      "bookingUrl": "https://cal.com/team/acme/30min",
      "hosts": [
        {
          "userId": 123,
          "name": "John Doe",
          "username": "john-doe",
          "mandatory": false,
          "priority": "medium",
          "avatarUrl": "https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
        }
      ],
      "schedulingType": "roundRobin",
      "team": {
        "id": 123,
        "slug": "<string>",
        "bannerUrl": "<string>",
        "name": "<string>",
        "logoUrl": "<string>",
        "weekStart": "<string>",
        "brandColor": "<string>",
        "darkBrandColor": "<string>",
        "theme": "<string>"
      },
      "bookingFields": [
        {
          "field": "name",
          "slug": "name",
          "variant": "fullName",
          "disableOnPrefill": true,
          "label": "<string>",
          "placeholder": "<string>"
        }
      ],
      "lengthInMinutesOptions": [
        15,
        30,
        60
      ],
      "slotInterval": 60,
      "minimumBookingNotice": 0,
      "beforeEventBuffer": 0,
      "afterEventBuffer": 0,
      "seatsPerTimeSlot": 123,
      "seatsShowAvailabilityCount": true,
      "bookingLimitsCount": {
        "day": 1,
        "week": 2,
        "month": 3,
        "year": 4
      },
      "bookerActiveBookingsLimit": {
        "maximumActiveBookings": 3,
        "offerReschedule": true
      },
      "onlyShowFirstAvailableSlot": true,
      "bookingLimitsDuration": {
        "day": 60,
        "week": 120,
        "month": 180,
        "year": 240,
        "disabled": false
      },
      "bookingWindow": [
        {
          "type": "businessDays",
          "value": 5,
          "rolling": true,
          "disabled": false
        }
      ],
      "bookerLayouts": {
        "defaultLayout": "month",
        "enabledLayouts": [
          "month"
        ]
      },
      "confirmationPolicy": {
        "type": "always",
        "blockUnconfirmedBookingsInBooker": true,
        "noticeThreshold": {
          "unit": "minutes",
          "count": 30
        },
        "disabled": false
      },
      "bookingProposalCount": 123,
      "requiresBookerEmailVerification": true,
      "skipAttendeeEmailDeliverabilityCheck": true,
      "emailSettings": {
        "disableEmailsToAttendees": true,
        "disableEmailsToHosts": true,
        "disableProposalEmailsToHosts": true
      },
      "hideCalendarNotes": true,
      "color": {
        "lightThemeHex": "#292929",
        "darkThemeHex": "#fafafa"
      },
      "seats": {
        "seatsPerTimeSlot": 4,
        "showAttendeeInfo": true,
        "showAvailabilityCount": true,
        "disabled": false
      },
      "offsetStart": 123,
      "customName": "<string>",
      "destinationCalendar": {
        "integration": "<string>",
        "externalId": "<string>"
      },
      "useDestinationCalendarEmail": true,
      "hideCalendarEventDetails": true,
      "hideOrganizerEmail": true,
      "calVideoSettings": {
        "disableRecordingForOrganizer": false,
        "disableRecordingForGuests": false,
        "redirectUrlOnExit": "<string>",
        "enableAutomaticRecordingForOrganizer": false,
        "enableAutomaticTranscription": false,
        "disableTranscriptionForGuests": false,
        "disableTranscriptionForOrganizer": false,
        "hideTranscriptionForGuests": false,
        "hideTranscriptionForOrganizer": false,
        "sendTranscriptionEmails": true,
        "disableAttendeeRecordingDownloadEmail": false,
        "transcriptionLanguage": "multi"
      },
      "disableCancelling": {
        "disabled": true
      },
      "disableRescheduling": {
        "disabled": true,
        "minutesBefore": 60
      },
      "interfaceLanguage": "<string>",
      "allowReschedulingPastBookings": true,
      "allowReschedulingCancelledBookings": true,
      "showOptimizedSlots": true,
      "privateNoteEnabled": true,
      "privateNoteMode": "duplicate_event",
      "privateNoteTemplate": "<string>",
      "ownerId": 123,
      "parentEventTypeId": 123,
      "assignAllTeamMembers": true,
      "rescheduleWithSameRoundRobinHost": true,
      "allowRRHostChoiceOnReschedule": true
    }
  ]
}

Headers

cal-api-version · string · default: 2026-06-12 · required

Must be set to 2026-06-12. If not set to this value, the endpoint will default to an older version.

Example:

"2026-06-12"

x-cal-secret-key · string

For platform customers - OAuth client secret key

x-cal-client-id · string

For platform customers - OAuth client ID

Authorization · string

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

orgId · number · required

Query Parameters

eventSlug · string

Slug of team event type to return.

hostsLimit · number

Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.

sortCreatedAt · enum<string>

Sort event types by creation date. When not provided, no explicit ordering is applied.

Available options: asc, desc

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object[] · required

Show child attributes