# List separations

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

Endpoint: GET /site/{siteId}/ahds/v1/separation
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", "name"

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

  - `category` (string)
    High-level category of separation.
    Enum: "ownership", "location", "grouping", "other"

  - `childEntityId` (string)
    Identifier of the child entity in the separation relationship (e.g., separated animal, destination group).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `clientProvidedId` (string)
    Optional client-supplied identifier for idempotency or cross-system correlation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string)
    Reference to the associated contact, if applicable.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `isActive` (boolean)
    Whether this separation record is currently active.

  - `name` (string)
    Human-readable name or label for the separation.

  - `parentEntityId` (string)
    Identifier of the parent entity in the separation relationship (e.g., owner, source group).
    Example: "123e4567-e89b-12d3-a456-426614174000"


## Response 200 fields

## Response 401 fields