Get scheduling configuration

Returns the scheduling configuration for a team event type. The response shape varies by scheduling type:

• roundRobin: Full configuration including hosts with priority, weight, and group assignment, host groups, and advanced settings (weights toggle, lead threshold, no-show calculations, CRM fallback).
• collective: Hosts with basic info and assignAllTeamMembers. Round-robin-specific fields are omitted.
• managed: Hosts with basic info and assignAllTeamMembers. Round-robin-specific fields are omitted.

Validates that the event type is a team event type. Returns 422 if the event type is not a team event type.

If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required.

GET /v2/event-types/{eventTypeId}/scheduling-config

Get scheduling configuration

cURL

curl --request GET \
  --url https://api.cal.com/v2/event-types/{eventTypeId}/scheduling-config \
  --header 'Authorization: <authorization>' \
  --header 'cal-api-version: <cal-api-version>'

200

{
  "status": "success",
  "data": {
    "eventTypeId": 1,
    "schedulingType": "roundRobin",
    "hosts": [
      {
        "userId": 1,
        "name": "John Doe",
        "username": "john-doe",
        "mandatory": false,
        "priority": "medium",
        "weight": 100,
        "avatarUrl": "<string>",
        "groupId": "<string>"
      }
    ],
    "assignAllTeamMembers": false,
    "hostGroups": [
      {
        "id": "<string>",
        "name": "Sales Team"
      }
    ],
    "rescheduleWithSameRoundRobinHost": false,
    "isRRWeightsEnabled": false,
    "maxLeadThreshold": 3,
    "includeNoShowInRRCalculation": false,
    "crmRecordOwnerFallbackWindowHours": 24
  }
}

Headers

cal-api-version · string · default: 2024-06-14 · required

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

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

eventTypeId · number · required

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object · required

Show child attributes