> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getaptly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List calendars

> Calendars the acting user can read: their own, plus calendars shared
with them or with one of their teams. Calendar access is per user, so an
API key or partner token must name the acting user in `userId`.




## OpenAPI

````yaml /openapi.yaml get /api/calendars
openapi: 3.0.3
info:
  title: Aptly API
  version: '1.1'
  description: |
    The Aptly API lets external systems work with boards, contacts, inboxes,
    tasks, files, and other Aptly resources.

    Most endpoints accept an API key in the `x-token` header. Some endpoints
    also accept a delegate token or partner bearer token, as shown in each
    operation's security requirements, and explicitly public endpoints require
    no credential. API keys are scoped to a company and may be restricted to
    specific boards and read, insert, or update permissions; requests outside
    those restrictions receive a 403 `FORBIDDEN` response.
servers:
  - url: https://core-api.getaptly.com
    description: Production
security:
  - ApiKeyHeader: []
paths:
  /api/calendars:
    get:
      tags:
        - Calendars
      summary: List calendars
      description: |
        Calendars the acting user can read: their own, plus calendars shared
        with them or with one of their teams. Calendar access is per user, so an
        API key or partner token must name the acting user in `userId`.
      operationId: listCalendars
      parameters:
        - name: userId
          in: query
          required: false
          schema:
            type: string
          description: >-
            Acting user. Required with an API key or partner token; a delegate
            token is its own user.
      responses:
        '200':
          description: Calendars, sorted by name.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        timezone:
                          type: string
                        isOwner:
                          type: boolean
                        isToursCalendar:
                          type: boolean
        '400':
          description: Invalid query, an empty window, or missing `userId`.
        '401':
          description: The acting user is not in the company.
        '403':
          description: API key without read permission.
      security:
        - ApiKeyHeader: []
        - DelegateToken: []
        - PartnerBearer: []
components:
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-token
    DelegateToken:
      type: apiKey
      in: header
      name: Authorization
      description: 'Delegate token issued by the platform. Format: `DelegateToken <token>`'
    PartnerBearer:
      type: http
      scheme: bearer
      description: 'Partner token. Format: `Authorization: Bearer <token>`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.