> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List all clinic client users

> 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.



## OpenAPI

````yaml get /ext/v2/clinic-client-users/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/clinic-client-users/:
    get:
      tags:
        - Clients And Patients
      summary: List all clinic client users
      description: >-
        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.
      operationId: clinic_client_users_list
      parameters:
        - description: When provided, filters to objects with these IDs.
          in: query
          name: ids
          required: false
          schema:
            anyOf:
              - items:
                  type: integer
                type: array
              - type: 'null'
            description: When provided, filters to objects with these IDs.
            title: Ids
        - description: >-
            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`.
          in: query
          name: ending_before
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              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`.
            title: Ending Before
        - description: >-
            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`.
          in: query
          name: starting_after
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              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`.
            title: Starting After
        - description: The maximum number of items to return per page.
          in: query
          name: limit
          required: false
          schema:
            default: 10
            description: The maximum number of items to return per page.
            maximum: 100
            minimum: 1
            title: Limit
            type: integer
        - description: >-
            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.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              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.
            title: Cursor
        - description: >-
            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.
          in: query
          name: modified__gte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              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.
            title: Modified  Gte
        - description: >-
            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.
          in: query
          name: modified__lte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              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.
            title: Modified  Lte
        - description: >-
            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.
          in: query
          name: is_deleted
          required: false
          schema:
            allOf:
              - enum:
                  - 'FALSE'
                  - 'TRUE'
                  - ALL
                title: DeletedFilterOption
                type: string
            default: 'FALSE'
            description: >-
              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.
        - description: Filters to clinic client users for the clinic with this ID.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Filters to clinic client users for the clinic with this ID.
            title: Clinic Id
        - description: >-
            Filters to clinic client users associated with the clinic client
            with the given ID.
          in: query
          name: clinic_client_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              Filters to clinic client users associated with the clinic client
              with the given ID.
            title: Clinic Client Id
        - description: >-
            When provided, filters to clinic client users with this exact
            primary email address.
          in: query
          name: email
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              When provided, filters to clinic client users with this exact
              primary email address.
            title: Email
        - description: >-
            When provided, filters to clinic client users with this exact
            10-digit primary phone number.
          in: query
          name: phone_number
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              When provided, filters to clinic client users with this exact
              10-digit primary phone number.
            title: Phone Number
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalClinicClientUserSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalClinicClientUserSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalClinicClientUserSchema'
          title: Data
          type: array
        has_more:
          default: false
          description: Whether there are more pages or data in this list.
          title: Has More
          type: boolean
        next_page:
          description: A URL linking to the next page of this list.
          title: Next Page
          type: string
        type:
          default: list
          description: Type of this object. Always `list`.
          title: Type
          type: string
      required:
        - data
        - next_page
      title: ExternalClinicClientUserSchemaList
      type: object
    ExternalClinicClientUserSchema:
      properties:
        clinic_client_id:
          description: The ID of the clinic client this clinic client user belongs to
          title: Clinic Client Id
          type: integer
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        custom_relationship:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            A custom relationship description if relationship_kind is set to
            'Other'.
          title: Custom Relationship
        deleted:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The datetime this record was soft deleted.
          title: Deleted
        email:
          anyOf:
            - type: string
            - type: 'null'
          description: The primary email address of the clinic client user.
          title: Email
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The first name of the clinic client user.
          title: First Name
        id:
          description: The ID of the clinic client user
          title: Id
          type: integer
        is_deleted:
          description: Whether this record is soft deleted or not.
          title: Is Deleted
          type: boolean
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The last name of the clinic client user.
          title: Last Name
        modified:
          description: >-
            The datetime this object was last modified; changes to related
            entities will not update this field.
          format: date-time
          title: Modified
          type: string
        phone_number:
          anyOf:
            - type: integer
            - type: 'null'
          description: The primary phone number of the clinic client user.
          title: Phone Number
        relationship_kind:
          anyOf:
            - $ref: '#/components/schemas/CoOwnerRelationshipKind'
            - const: ''
              type: string
            - type: 'null'
          description: >-
            The type of relationship this clinic client user has to the clinic
            client account.
          title: Relationship Kind
      required:
        - created
        - modified
        - is_deleted
        - deleted
        - id
        - clinic_client_id
      title: ExternalClinicClientUserSchema
      type: object
    CoOwnerRelationshipKind:
      enum:
        - SPOUSE
        - PARTNER
        - PARENT
        - CHILD
        - SIBLING
        - OTHER
      title: CoOwnerRelationshipKind
      type: string
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````