---
title: "/calendars"
url: "https://developers.rest.rodeo/apis/calendar/versions/9fa518e1-4597-4801-ad08-2c360cda2316/operations/listCalendars"
---

> Full API specification: https://developers.rest.rodeo/apis/calendar/versions/9fa518e1-4597-4801-ad08-2c360cda2316.md

# /calendars

`GET` `/calendars`

Operation ID: `listCalendars`

Lists every calendar.

## Responses

- `200` - All calendars
- `401` - Missing or invalid bearer token
- `405` - Method not allowed

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Calendar API
  version: 1.0.0
servers:
  - url: https://api.rest.rodeo/calendar/api/v1
    description: Production
paths:
  /calendars:
    get:
      operationId: listCalendars
      summary: /calendars
      description: Lists every calendar.
      responses:
        "200":
          description: All calendars
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/CalendarsList"
              examples:
                calendars:
                  value:
                    calendars:
                      - id: 3d8df2a2-0d68-4dc4-9d5e-6b1e94a7a51d
                        name: Work
        "401":
          description: Missing or invalid bearer token
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "405":
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
security:
  - bearerAuth: []
components:
  schemas:
    CalendarsList:
      type: object
      required:
        - calendars
      additionalProperties: false
      properties:
        calendars:
          type: array
          items:
            $ref: "#/components/schemas/Calendar"
    Error:
      type: object
      required:
        - error
      additionalProperties: false
      properties:
        error:
          type: string
    Calendar:
      type: object
      required:
        - id
        - name
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
          description: The calendar id.
        name:
          type: string
          description: The calendar name.
          maxLength: 256
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```