---
title: "Fetch all appointments"
method: GET
path: "/api/v1/appointments"
tags: ["Appointments"]
---

# Fetch all appointments

`GET /api/v1/appointments`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/appointments`
- Auth: none declared. Required headers: `Api-Key`

Returns a paginated list of appointments for the business. Results can be filtered by date range, staff member, brand, cancellation status, and text search.

Set `staff_id` to `my` to return only appointments assigned to the authenticated user.

The response includes `meta.total_count` and `meta.per_page` for pagination.

**Required permission:** `assigned_appointment_read` or `unassigned_appointment_read`

## Query parameters

- `start_date` string
- `end_date` string
- `staff_id` string
- `brand_id` integer
- `canceled_status` string
- `past_or_future` string
- `search_text` string
- `page` integer
- `per` integer

## Headers

- `Api-Key` string, required

## Response `200`

appointments found

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)