---
title: "Get a connected calendar"
method: GET
path: "/v2/api/calendars/{id}"
tags: ["AI Receptionist"]
---

# Get a connected calendar

`GET /v2/api/calendars/{id}`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/calendars/{id}`
- Auth: API key in header `Authorization`

Returns one connected calendar with the event types its provider currently offers, read live from the provider. This is the catalog you pick from when filling `scheduling.calendars`.

## Path parameters

- `id` string, required

## Response `200`

The calendar and its available event types

- object
  - `data` Calendar: A calendar connected to your workspace, whether or not a receptionist books on it.
    - `id` string: What `scheduling.calendars` on `PATCH /v2/api/numbers/{number}/agent` is keyed by.
    - `name` string, nullable
    - `provider` 'GOOGLE_CALENDAR' | 'CAL_COM' | 'CALENDLY' | 'OUTLOOK'
    - `status` 'ACTIVE' | 'DISCONNECTED'
    - `is_team_default` boolean
    - `owner` CalendarOwner: The teammate who connected the calendar.
      - `user_id` string
      - `user_name` string, nullable
      - `email` string, nullable
      - `is_current_user` boolean
    - `available_event_types` CalendarEventType[], nullable: Reported by `GET /v2/api/calendars/{id}` only, read live from the provider. Absent for a provider with no event-type concept, which is not the same answer as an empty list.
      - `id` string
      - `slug` string, nullable
      - `title` string
      - `length_in_minutes` integer, nullable
      - `provider_description` string, nullable: The blurb written in the calendar provider. Not the routing note the receptionist matches on: that one is the `description` you send in `scheduling.calendars`.
      - `required_questions` SchedulingQuestion[], nullable
        - `id` string
        - `label` string

## Other responses

- `401`: Invalid or missing API key
- `403`: API key lacks the required scope or access to the resource
- `404`: Resource not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/calendars/:id/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)