---
title: "Get the destination calendar (with event-type fallback)"
method: GET
path: "/appointments/calendars/destination"
tags: ["Appointments"]
---

# Get the destination calendar (with event-type fallback)

`GET /appointments/calendars/destination`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/calendars/destination`
- Auth: HTTP bearer

Get the destination calendar for the caller. When ``event_type_id`` is
provided, returns the event-type-specific override if one exists, falling
back to the user-level default. Returns ``{data: null}`` when none is set.
Reuses the in-app get_destination_calendar logic.

## Query parameters

- `event_type_id` integer, nullable

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Response `200`

Successful Response

- DestinationCalendarEnvelope: Envelope for GET/PUT /calendars/destination. ``data`` is ``null`` when no destination calendar is configured.
  - `data` DestinationCalendarResponse
    - `id` integer, required
    - `integration` string, required
    - `external_id` string, required
    - `credential_id` integer, nullable
    - `event_type_id` integer, nullable
    - `primary_email` string, nullable

## Other responses

- `422`: Validation Error

---

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