Skip to main content
GET
/
v2
/
teams
/
{teamId}
/
event-types
Get a team event type
curl --request GET \
  --url https://api.cal.com/v2/teams/{teamId}/event-types
{
  "status": "success",
  "data": [
    {
      "id": 1,
      "lengthInMinutes": 60,
      "lengthInMinutesOptions": [
        15,
        30,
        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
        }
      ],
      "bookingFields": [
        {
          "type": "name",
          "label": "<string>",
          "placeholder": "<string>",
          "disableOnPrefill": true,
          "isDefault": true,
          "slug": "name",
          "required": true
        }
      ],
      "disableGuests": true,
      "slotInterval": 60,
      "minimumBookingNotice": 0,
      "beforeEventBuffer": 0,
      "afterEventBuffer": 0,
      "recurrence": {
        "interval": 10,
        "occurrences": 10,
        "frequency": "yearly"
      },
      "metadata": {},
      "price": 123,
      "currency": "<string>",
      "lockTimeZoneToggleOnBookingPage": true,
      "seatsPerTimeSlot": {},
      "forwardParamsSuccessRedirect": {},
      "successRedirectUrl": {},
      "isInstantEvent": true,
      "seatsShowAvailabilityCount": true,
      "scheduleId": 123,
      "bookingLimitsCount": {},
      "bookerActiveBookingsLimit": {
        "maximumActiveBookings": 3,
        "offerReschedule": true
      },
      "onlyShowFirstAvailableSlot": true,
      "bookingLimitsDuration": {},
      "bookingWindow": [
        {
          "type": "businessDays",
          "value": 5,
          "rolling": true
        }
      ],
      "bookerLayouts": {
        "defaultLayout": "month",
        "enabledLayouts": [
          "month"
        ]
      },
      "confirmationPolicy": {},
      "requiresBookerEmailVerification": true,
      "hideCalendarNotes": true,
      "color": {
        "lightThemeHex": "#292929",
        "darkThemeHex": "#fafafa"
      },
      "seats": {
        "seatsPerTimeSlot": 4,
        "showAttendeeInfo": true,
        "showAvailabilityCount": true
      },
      "offsetStart": 123,
      "customName": "<string>",
      "destinationCalendar": {
        "integration": "<string>",
        "externalId": "<string>"
      },
      "useDestinationCalendarEmail": true,
      "hideCalendarEventDetails": true,
      "hideOrganizerEmail": true,
      "calVideoSettings": {
        "disableRecordingForOrganizer": true,
        "disableRecordingForGuests": true,
        "redirectUrlOnExit": {},
        "enableAutomaticRecordingForOrganizer": true,
        "enableAutomaticTranscription": true,
        "disableTranscriptionForGuests": true,
        "disableTranscriptionForOrganizer": true
      },
      "hidden": true,
      "bookingRequiresAuthentication": true,
      "teamId": 123,
      "ownerId": {},
      "parentEventTypeId": {},
      "hosts": [
        "<string>"
      ],
      "assignAllTeamMembers": true,
      "schedulingType": "roundRobin",
      "team": {
        "id": 123,
        "slug": "<string>",
        "bannerUrl": "<string>",
        "name": "<string>",
        "logoUrl": "<string>",
        "weekStart": "<string>",
        "brandColor": "<string>",
        "darkBrandColor": "<string>",
        "theme": "<string>"
      },
      "emailSettings": {
        "disableEmailsToAttendees": true,
        "disableEmailsToHosts": true
      },
      "rescheduleWithSameRoundRobinHost": true
    }
  ]
}

Path Parameters

​
teamId
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