v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB

Event Types

Get an event type

<Note>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.</Note>

Access control: This endpoint fetches an event type by ID and returns it only if the authenticated user is authorized. Authorization is granted to:
- System admins
- The event type owner
- Hosts of the event type or users assigned to the event type
- Team admins/owners of the team that owns the team event type
- Organization admins/owners of the event type owner's organization
- Organization admins/owners of the team's parent organization

Note: Update and delete endpoints remain restricted to the event type owner only.

get/v2/event-types/{eventTypeId}

Path parameters

eventTypeIdstring required

Headers

cal-api-versionstring required

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

Authorizationstring required

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

Response

status'success' | 'error' required

Example response

{
  "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"
      }
    ],
    "bookingFields": [
      {
        "type": "name"
      }
    ],
    "recurrence": {
      "interval": 10,
      "occurrences": 10
    },
    "bookerActiveBookingsLimit": {
      "maximumActiveBookings": 3
    },
    "bookingWindow": [
      {
        "value": 5,
        "rolling": true
      }
    ],
    "color": {
      "lightThemeHex": "#292929",
      "darkThemeHex": "#fafafa"
    },
    "seats": {
      "seatsPerTimeSlot": 4,
      "showAttendeeInfo": true,
      "showAvailabilityCount": true
    },
    "disableCancelling": {
      "disabled": true
    },
    "disableRescheduling": {
      "disabled": true,
      "minutesBefore": 60
    },
    "ownerId": 10,
    "bookingUrl": "https://cal.com/john-doe/30min"
  }
}