# List appointments

Retrieve a paginated list of appointments for the account. Supports filtering by location, practitioner, patient, date range, and status. Results are sorted by appointment start time by default.

Endpoint: GET /partner/v2/account/{accountId}/location/{locationId}/appointment
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `practitionerId` (integer)
    Filter by practitioner ID (staff member with a practitioner role)

  - `patientId` (integer)
    Filter by patient ID

  - `appointmentTypeId` (integer)
    Filter by appointment type ID

  - `status` (string)
    Filter by status (SCHEDULED, CONFIRMED, CHECKED_IN, IN_TREATMENT, CHECKED_OUT, CANCELLED, NO_SHOW)

  - `startDate` (string)
    Start of date range (ISO 8601)
    Example: "2025-01-01T00:00:00Z"

  - `endDate` (string)
    End of date range (ISO 8601)
    Example: "2025-01-31T23:59:59Z"

  - `sortBy` (string)
    Sort by field
    Enum: "START_TIME", "CREATED_DATE"

  - `sortDir` (string)
    Sort direction
    Enum: "ASC", "DESC"

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

  - `locationId` (integer, required)
    Location identifier

## Response 200 fields (application/json):

  - `appointments` (array)
    List of appointments in this page

  - `appointments.appointmentTypeId` (integer)
    Appointment type ID
    Example: 333

  - `appointments.createdAt` (string)
    Creation timestamp
    Example: "2025-01-10T14:30:00Z"

  - `appointments.durationMinutes` (integer)
    Duration in minutes
    Example: 30

  - `appointments.endTime` (string)
    Appointment end time (ISO 8601)
    Example: "2025-01-15T09:30:00-05:00"

  - `appointments.id` (integer)
    Unique appointment identifier
    Example: 12345

  - `appointments.locationId` (integer)
    Location ID
    Example: 111

  - `appointments.note` (string)
    Appointment notes
    Example: "Annual checkup"

  - `appointments.patientId` (integer)
    Patient ID
    Example: 67890

  - `appointments.practitionerId` (integer)
    Practitioner ID (staff member with a practitioner role)
    Example: 222

  - `appointments.startTime` (string)
    Appointment start time (ISO 8601)
    Example: "2025-01-15T09:00:00-05:00"

  - `appointments.status` (string)
    Appointment status
    Enum: "SCHEDULED", "CONFIRMED", "CHECKED_IN", "IN_TREATMENT", "CHECKED_OUT", "CANCELLED", "NO_SHOW"

  - `appointments.updatedAt` (string)
    Last update timestamp
    Example: "2025-01-10T14:30:00Z"

  - `nextCursor` (string)
    Opaque cursor for fetching the next page. Null if no more results.


## Response 400 fields

## Response 401 fields

## Response 403 fields