Busy Times (v2)

GET

/v2/users/{userId}/busy_times

Returns busy time windows for a user within the specified date range. The range must be 7 days or less.

Differences from v1:

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

If any of the user's calendars cannot be read, the request fails with 424 instead of returning partial busy times.

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2/users//busy_times?start=2026-10-01T00%3A00%3A00Z&end=2026-10-07T00%3A00%3A00Z' \
--header 'Authorization: Bearer <token>'

🟢200Success

application/json

Bodyapplication/json

Example

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

🟠400Bad Request

🟠424Failed Dependency

Modified at 2026-09-29 04:49:50