---
title: "Get a paginated and filtered list of appointments"
method: GET
path: "/Appointments"
tags: ["Appointments"]
---

# Get a paginated and filtered list of appointments

`GET /Appointments`

## Query parameters

- `page` union
  - integer
  - string, int32
- `pageSize` union
  - integer
  - string, int32
- `startDate` string, date-time
- `endDate` string, date-time
- `status` string
- `clientId` string
- `patientId` string
- `locationId` string
- `assignedToId` string
- `search` string

## Response `200`

Paginated list of appointments

- AppointmentListResponse — Paginated appointment list response
  - `data` AppointmentListItemDto[]
    - `id` string
    - `scheduleItemId` string
    - `patientId` string, nullable — Patient or group ID — populated from whichever side of the polymorphic appointment is set.
    - `patientGroupId` string, nullable
    - `clientId` string
    - `title` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `clientName` string
    - `patientName` string — For group visits this is the group name + type (e.g. "Bella's June litter (Litter)").
    - `species` string, nullable
    - `breed` string, nullable
    - `dateOfBirth` string, date-time, nullable
    - `vaccinationStatus` string, nullable
    - `subjectKind` string — "Patient" or "Group" — lets the schedule UI render a group icon instead of a paw.
    - `reasonForVisit` string
    - `notes` string, nullable — Free-text appointment notes. Surfaced in the patient's visit-history card so visits with notes but no structured record (e.g. imported history) aren't shown empty.
    - `status` string
    - `location` string
    - `locationId` string, nullable — Schedule item's location id — lets the UI default a room picker to the current room.
    - `assignedTo` string, nullable
    - `isCompassionCare` boolean — True when this appointment's type is flagged as compassion / euthanasia / end-of-life care.
    - `patientAlerts` string[]
    - `patientTreatmentAcceptanceRate` union — Read-only lifetime treatment-acceptance rate (0-100) for the patient, or null when the patient has no decided services (or this is a group visit). Surfaced on the EMR visit list.
      - number, double
      - string, double
  - `totalCount` union
    - integer
    - string, int32
  - `page` union
    - integer
    - string, int32
  - `pageSize` union
    - integer
    - string, int32
  - `totalPages` union
    - integer
    - string, int32

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/d8d7501dde48/schema)