---
title: "List user calendars"
method: GET
path: "/v1/users/{user_id}/calendars"
tags: ["Calendars"]
---

# List user calendars

`GET /v1/users/{user_id}/calendars`

## Request

- Base URL: `http://0.0.0.0:3000`
- URL: `http://0.0.0.0:3000/v1/users/{user_id}/calendars`
- Auth: none declared

Returns all calendars discovered for a user's calendar integrations.

**Filtering:**
- `integration_id`: Filter to a specific integration (int_xxx format)
- `active`: Filter by active status (true/false)

**Expand parameter**:
By default, `description` is not included.
Use `expand=description` to include calendar descriptions.

**Pagination:**
- `limit`: Maximum number of calendars to return (default: 100, max: 100)
- `offset`: Number of calendars to skip for pagination (default: 0)

**Note:** By default, only the primary calendar is active. Use PATCH to activate additional calendars.

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `integration_id` string
- `active` 'true' | 'false'
- `limit` string
- `offset` string
- `expand` string

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `error` object
    - `code` string, required
    - `message` string, required
    - `details` unknown
  - `data` object[], required
    - `id` string, required: Opaque calendar ID (cal_xxx format)
    - `integration_id` string, required: Opaque integration ID (int_xxx format)
    - `title` string, nullable: Calendar display name
    - `description` string, nullable: Calendar description
    - `active` boolean, required: Whether this calendar is being synced
    - `created_at` string, date-time, required: When the calendar was discovered
    - `updated_at` string, date-time, nullable: When the calendar was last modified
  - `pagination` object, required
    - `limit` number, required
    - `offset` number, required
    - `has_more` boolean, required
    - `total_count` number

## Other responses

- `400`: Default Response
- `401`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/attrove/apis/attrove-api.md) · [All operations](https://skmtc.dev/attrove/apis/attrove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/attrove/apis/attrove-api/revisions/fcdc818b45cb?raw)