# List appointments

Returns a paginated list of Appointments for the specified site. Supports filtering and sorting.

Endpoint: GET /site/{siteId}/ahds/v1/appointment
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Query parameters:

  - `page` (number)
    Page number (0-indexed)

  - `pageSize` (number)
    Number of items per page

  - `sortBy` (string)
    Field to sort by
    Enum: "createdAt", "updatedAt", "cancellationReasonText", "description", "durationMinutes", "startAt"

  - `sortOrder` (string)
    Sort order
    Enum: "asc", "desc"

  - `animalId` (string)
    Identifier of the animal associated with the appointment.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `cancellationReasonText` (string)
    Free-text explanation of the cancellation reason.

  - `consultId` (string)
    Identifier of the consult/visit record linked to this appointment.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string)
    Identifier of the primary contact (e.g., owner) for the appointment.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `description` (string)
    Free-text description or notes for the appointment.

  - `isActive` (boolean)
    Whether the appointment is currently active (not deleted/voided).

  - `primaryResourceId` (string)
    Identifier of the primary resource responsible for the appointment (e.g., veterinarian).
    Example: "123e4567-e89b-12d3-a456-426614174000"


## Response 200 fields

## Response 401 fields