# List animals

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

Endpoint: GET /site/{siteId}/ahds/v1/animal
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", "code", "deathReason", "desexDate", "microchipNumber", "name", "notes", "rabiesNumber", "rabiesVaccinationDate", "birthDate", "deathDate"

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

  - `code` (string)
    Practice-specific animal code or chart number.

  - `deathReason` (string)
    Free-text reason for death.

  - `hasImportantNotes` (boolean)
    True if notes contain important or highlighted information.

  - `isActive` (boolean)
    Whether the animal record is active in the source system.

  - `isDead` (boolean)
    Whether the animal is deceased. Should be consistent with deathDate when present.

  - `isEstimatedDateOfBirth` (boolean)
    True if the date of birth is estimated rather than exact.

  - `isHostile` (boolean)
    Whether the animal is marked as hostile or aggressive.

  - `microchipNumber` (string)
    Microchip identifier.

  - `name` (string)
    Animal's name.

  - `notes` (string)
    General clinical or administrative notes about the animal.

  - `ownerContactId` (string)
    Canonical identifier of the primary owner contact.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `rabiesNumber` (string)
    Rabies vaccination certificate or tag number.

  - `referringClinicId` (string)
    Canonical identifier of the referring clinic.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `referringVetId` (string)
    Canonical identifier of the referring veterinarian.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `residenceContactId` (string)
    Canonical identifier of the residence contact (if different from owner).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resuscitationStatus` (string)
    Resuscitation preference for the animal.
    Enum: "full", "do_not_resuscitate", "unspecified"

  - `herdId` (string)
    Optional herd identifier for production animals.
    Example: "123e4567-e89b-12d3-a456-426614174000"


## Response 200 fields

## Response 401 fields