Get Event Type Available Schedules (v2)

Previous version: Get Event Type Available Schedules (v1)

Returns a list of available times for an event type within a specified date range. Date range can be no greater than 7 days.

Differences from v1:

Reading this endpoint never sends calendar connection error email and never updates calendar authentication error state.

When a host's external calendar cannot be read, the request fails with 424 if all hosts must attend, if every host failed, if any host's calendar is temporarily unavailable, or if a resource calendar failed. If some hosts need to reconnect their calendar and any one host is enough, those hosts are excluded, the remaining slots are returned with 200, and calendarNotice states that the excluded hosts will not be assigned to bookings made in these slots.

calendarNotice.hosts and host names in calendarNotice.message are returned only when the caller is a team Owner or Admin.

Authentication: x-jicoo-api-key, or an OIDC Bearer token with the event_types.read scope and the X-Jicoo-Team header.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

All host calendars were readSome hosts excluded (Owner / Admin caller)Some hosts excluded (Member caller)

{
    "data": [
        {
            "startedAt": "2026-10-01T01:00:00.000Z",
            "remainingCapacity": 1
        },
        {
            "startedAt": "2026-10-01T02:00:00.000Z",
            "remainingCapacity": 1
        }
    ]
}

🟠400Bad Request

🟠404Not Found

🟠424Failed Dependency