Busy Times

GET

/v1/users/{userId}/busy_times

For new integrations, use v2: Busy Times (v2). v2 never sends calendar connection error email, and returns an explicit error instead of partial results when calendars cannot be read.

Returns busy time windows for a user within the specified date range.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/users//busy_times?start=2026-06-15T00%3A00%3A00Z&end=2026-06-22T00%3A00%3A00Z' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

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

Modified at 2026-09-29 04:47:00

Busy Times (v2)

Check Calendar Connection (v2)