---
title: "List the caller's bookings (paginated)"
method: GET
path: "/appointments/bookings"
tags: ["Appointments"]
---

# List the caller's bookings (paginated)

`GET /appointments/bookings`

## Request

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

List bookings visible to the caller.

Personal keys retain the member-scoped path. An organization key that
passed the existing explicit ``meetings:read`` gate uses the handler's
org-wide read path and therefore never looks up the synthetic API identity.

## Query parameters

- `status` string, nullable: Filter by status: accepted | pending | cancelled | rejected.
- `event_type_id` integer, nullable: Only bookings for this event type.
- `after_start` string, nullable: ISO-8601 lower bound on start_time.
- `before_end` string, nullable: ISO-8601 upper bound on end_time.
- `attendee_email` string, nullable: Filter by an attendee email.
- `sort_by` string: start_time | end_time | created_at | status.
- `sort_order` string
- `skip` integer
- `take` integer

## Headers

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

## Response `200`

Successful Response

- object

## 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)