---
title: "List all clinic client users"
method: GET
path: "/ext/v2/clinic-client-users/"
tags: ["Clients And Patients"]
---

# List all clinic client users

`GET /ext/v2/clinic-client-users/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/clinic-client-users/`
- Auth: HTTP bearer

Returns a list of all clinic client users across all clinics in the organization. The clinic client users are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead.

A **clinic client user** represents an individual person associated with a clinic client account. When a pet has multiple owners (co-owners), each person is a separate clinic client user under the same clinic client. The primary clinic client user is the main account holder whose name and contact information appear on the parent clinic client record.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_id` integer, nullable: Filters to clinic client users for the clinic with this ID.
- `clinic_client_id` integer, nullable: Filters to clinic client users associated with the clinic client with the given ID.
- `email` string, nullable: When provided, filters to clinic client users with this exact primary email address.
- `phone_number` integer, nullable: When provided, filters to clinic client users with this exact 10-digit primary phone number.

## Response `200`

OK

- ExternalClinicClientUserSchemaList
  - `data` ExternalClinicClientUserSchema[], required: A single page of data contained within this list.
    - `clinic_client_id` integer, required: The ID of the clinic client this clinic client user belongs to
    - `created` string, date-time, required: The datetime this object was created.
    - `custom_relationship` string, nullable: A custom relationship description if relationship_kind is set to 'Other'.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `email` string, nullable: The primary email address of the clinic client user.
    - `first_name` string, nullable: The first name of the clinic client user.
    - `id` integer, required: The ID of the clinic client user
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `last_name` string, nullable: The last name of the clinic client user.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `phone_number` integer, nullable: The primary phone number of the clinic client user.
    - `relationship_kind` union: The type of relationship this clinic client user has to the clinic client account.
      - 'SPOUSE' | 'PARTNER' | 'PARENT' | 'CHILD' | 'SIBLING' | 'OTHER'
      - ''
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)