---
title: "Get a paginated list of clients with optional search and sorting"
method: GET
path: "/Clients"
tags: ["Clients"]
---

# Get a paginated list of clients with optional search and sorting

`GET /Clients`

## Query parameters

- `page` union
  - integer
  - string, int32
- `pageSize` union
  - integer
  - string, int32
- `query` string
- `sortBy` string
- `sortOrder` string
- `tagId` string

## Response `200`

Paginated list of clients

- ClientListResponseDto
  - `data` ClientResponseDto[]
    - `id` string
    - `email` string, nullable
    - `phoneNumber` string, nullable
    - `firstName` string
    - `lastName` string
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zipCode` string, nullable
    - `countryCode` string, nullable — ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). Defaults to clinic's region if null.
    - `dateOfBirth` string, date-time, nullable
    - `accountStatus` integer
    - `emergencyContact` EmergencyContactDto
      - `name` string, nullable
      - `phone` string, nullable
      - `email` string, nullable
      - `relationship` string, nullable
    - `secondaryEmergencyContact` SecondaryEmergencyContactDto — A client's secondary (backup) emergency contact — free-text, same shape as the primary one (PAW-650). Backed by the `SecondaryEmergencyContact*` columns on the client.
      - `name` string, nullable
      - `phone` string, nullable
      - `email` string, nullable
      - `relationship` string, nullable
    - `communicationPreferences` CommunicationPreferencesDto
      - `preferredMethod` integer
      - `allowAppointmentReminders` boolean
      - `allowEmailMarketing` boolean
      - `allowPhoneCalls` boolean
      - `allowSmsMarketing` boolean
      - `notes` string, nullable
    - `preferredLanguage` string, nullable
    - `referralSource` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `totalCount` union
    - integer
    - string, int32
  - `page` union
    - integer
    - string, int32
  - `pageSize` union
    - integer
    - string, int32
  - `totalPages` union
    - integer
    - string, int32

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/a905bde4e796/schema)