---
title: "List bookable calendar event types (Cal.com appointments)"
method: GET
path: "/event-types"
tags: ["GTM Launch Helpers"]
---

# List bookable calendar event types (Cal.com appointments)

`GET /event-types`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/event-types`
- Auth: HTTP bearer

Return the org's bookable event types (calendar links).

Each row carries `id` (integer) and the booking-page metadata. Pass `id`
back as `appointment_id` on `POST /campaigns/{id}/launch` or
`PATCH /sequences/{id}` to wire the booking link onto a sequence so the
Cal.com short-link rewrite kicks in during send.

Backed by the appointments `EventTypesHandler.handle_list` (same handler
powering the in-app /appointments/event-types picker). We pass the
authenticated user through so per-user visibility rules apply identically
to the in-app flow.

## Query parameters

- `include_hidden` boolean: Include event types marked `hidden` (unbookable publicly). Default False.
- `scheduling_type` string, nullable: Filter by Cal.com scheduling type: managed | round_robin | collective. Omit to return all types including single-host (NULL).

## Headers

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

## Response `200`

Successful Response

- EventTypesListResponse: Envelope for `GET /event-types`.
  - `data` EventTypeListItem[], required
    - `id` integer, required: Event-type integer ID; pass back to launch / PATCH endpoints as `appointment_id`.
    - `title` string, required: Display title shown on the booking page.
    - `slug` string, required: URL-safe slug (the path segment used in `appointments/team/...` links).
    - `length` integer, required: Slot duration in minutes.
    - `description` string, nullable
    - `scheduling_type` string, nullable: Cal.com scheduling type: managed | round_robin | collective | None (= single-host).
    - `hidden` boolean: When True the event type is not bookable publicly. Excluded by default.
    - `schedule_id` integer, nullable: ID of the availability schedule attached to this event type, if any.

## 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/89fc11143b70?raw)