# List communications

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

Endpoint: GET /site/{siteId}/ahds/v1/communication
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", "associatedResourceType", "communicatingResourceType", "content", "destination", "origin", "readAt", "subject"

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

  - `associatedResourceId` (string)
    Identifier of the resource this communication is associated with.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `associatedResourceType` (string)
    Type of resource this communication is associated with (e.g. Contact, Animal, Consult).

  - `communicatingResourceId` (string)
    Identifier of the communicating party when different from associatedResourceId.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `communicatingResourceType` (string)
    Type of the communicating party (e.g. Contact, Animal) when different from associatedResourceType.

  - `contactDetailTypeId` (string)
    Identifier of the ContactDetailType used to send the communication.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `content` (string)
    Body/content of the communication.

  - `contentFormat` (string)
    Format of the communication content.
    Enum: "SMS", "PLAINTEXT", "HTML"

  - `destination` (string)
    Destination address/identifier for the communication, format defined by contactDetailTypeId.

  - `direction` (string)
    Direction of the communication relative to the practice.
    Enum: "OUTGOING", "INCOMING"

  - `isActive` (boolean)
    Whether the communication record is active.

  - `origin` (string)
    Origin address/identifier for the communication, if available.

  - `status` (string)
    Delivery or processing status of the communication.
    Enum: "PENDING", "DONE", "SENDING", "FAILED"

  - `subject` (string)
    Subject or title of the communication.


## Response 200 fields

## Response 401 fields