# List addresses

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

Endpoint: GET /site/{siteId}/ahds/v1/address
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", "city", "countryCode", "latitude", "line1", "line2", "longitude", "name", "postalCode", "region", "state", "suburb"

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

  - `city` (string)
    City, town, or locality.

  - `contactId` (string)
    Identifier of the contact this address belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `countryCode` (string)
    ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.

  - `isActive` (boolean)
    Whether the address is currently active/usable.

  - `line1` (string)
    First line of the street address.

  - `line2` (string)
    Second line of the street address.

  - `name` (string)
    Optional label or name for the address (e.g., 'Home', 'Work').

  - `postalCode` (string)
    Postal or ZIP code.

  - `region` (string)
    Region, province, or county.

  - `state` (string)
    State or territory (where applicable).

  - `suburb` (string)
    Suburb, neighborhood, or village.


## Response 200 fields

## Response 401 fields