Teams / Event Types
Get a team event type
Getting Started
Platform / Cal Provider
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Delegation Credentials
Orgs / Event Types
Orgs / Memberships
Orgs / Orgs
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Memberships
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Schedules
Orgs / Users / OOO
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Teams / Event Types
Get a team event type
GET
/
v2
/
teams
/
{teamId}
/
event-types
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": 123,
"forwardParamsSuccessRedirect": true,
"successRedirectUrl": "<string>",
"isInstantEvent": true,
"seatsShowAvailabilityCount": true,
"scheduleId": 123,
"bookingLimitsCount": {},
"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": 2,
"customName": "<string>",
"destinationCalendar": {
"integration": "<string>",
"externalId": "<string>"
},
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"teamId": 123,
"ownerId": 123,
"parentEventTypeId": 123,
"hosts": [
{
"userId": 123,
"mandatory": false,
"priority": "medium",
"name": "John Doe",
"avatarUrl": "https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
}
],
"assignAllTeamMembers": true,
"schedulingType": "ROUND_ROBIN",
"team": {
"id": 123,
"slug": "<string>",
"bannerUrl": "<string>",
"name": "<string>",
"logoUrl": "<string>",
"weekStart": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"theme": "<string>"
}
}
]
}Path Parameters
Query Parameters
Slug of team event type to return.
Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.
Response
200 - application/json
Available options:
success, error Example:
"success"
Example:
1
Required range:
x >= 1Example:
60
Example:
"Learn the secrets of masterchief!"
Example:
"learn-the-secrets-of-masterchief"
Example:
"Discover the culinary wonders of Argentina by making the best flan ever!"
only allowed value for type is address
Available options:
address, link, integration, phone, attendeeAddress, attendeePhone, attendeeDefined, organizersDefaultApp Example:
"address"
Example:
"123 Example St, City, Country"
only allowed value for type is name. Used for having 1 booking field for both first name and last name.
Available options:
name, email, phone, address, text, number, textarea, select, multiselect, multiemail, checkbox, radio, boolean, url Example:
"name"
This property is always true because it's a default field
Example:
true
Disable this booking field if the URL contains query parameter with key equal to the slug and prefill it with the provided value. For example, if URL contains query parameter &name=bob, the name field will be prefilled with this value and disabled.
Which user is the host of this event
Example:
"John Doe"
Only relevant for round robin event types. If true then the user must attend round robin event always.
Available options:
lowest, low, medium, high, highest Example:
"https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
Available options:
ROUND_ROBIN, COLLECTIVE, MANAGED If you want that user can choose between different lengths of the event you can specify them here. Must include the provided lengthInMinutes.
Example:
[15, 30, 60]
Example:
60
Required range:
x >= 0Example:
0
Required range:
x >= 0Example:
0
Required range:
x >= 0Example:
0
Limit how far in the future this event can be booked
Whether the window should be business days, calendar days or a range of dates
Available options:
businessDays, calendarDays, range How many business day into the future can this event be booked
Example:
5
Determines the behavior of the booking window:
- If **true**, the window is rolling. This means the number of available days will always be equal the specified 'value'
and adjust dynamically as bookings are made. For example, if 'value' is 3 and availability is only on Mondays,
a booker attempting to schedule on November 10 will see slots on November 11, 18, and 25. As one of these days
becomes fully booked, a new day (e.g., December 2) will open up to ensure 3 available days are always visible.
- If **false**, the window is fixed. This means the booking window only considers the next 'value' days from the
moment someone is trying to book. For example, if 'value' is 3, availability is only on Mondays, and the current
date is November 10, the booker will only see slots on November 11 because the window is restricted to the next
3 calendar days (November 10–12).
Example:
true
Required range:
x >= 1The integration type of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the integration type of your connected calendars.
The external ID of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the external IDs of your connected calendars.
For managed event types, parent event type is the event type that this event type is based on
Was this page helpful?
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": 123,
"forwardParamsSuccessRedirect": true,
"successRedirectUrl": "<string>",
"isInstantEvent": true,
"seatsShowAvailabilityCount": true,
"scheduleId": 123,
"bookingLimitsCount": {},
"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": 2,
"customName": "<string>",
"destinationCalendar": {
"integration": "<string>",
"externalId": "<string>"
},
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"teamId": 123,
"ownerId": 123,
"parentEventTypeId": 123,
"hosts": [
{
"userId": 123,
"mandatory": false,
"priority": "medium",
"name": "John Doe",
"avatarUrl": "https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
}
],
"assignAllTeamMembers": true,
"schedulingType": "ROUND_ROBIN",
"team": {
"id": 123,
"slug": "<string>",
"bannerUrl": "<string>",
"name": "<string>",
"logoUrl": "<string>",
"weekStart": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"theme": "<string>"
}
}
]
}