> ## 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 client email addresses

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

A **client email address** represents an email address associated with a clinic client (pet parent). Each client can have multiple email addresses.



## OpenAPI

````yaml get /ext/v2/client-email-addresses/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/client-email-addresses/:
    get:
      tags:
        - Inbox
      summary: List all client email addresses
      description: >-
        Returns a list of all client email addresses across all clinics in the
        organization. The email addresses are sorted by creation date, with the
        most recent appearing first. When using modified filters, results are
        sorted in descending modification date instead.


        A **client email address** represents an email address associated with a
        clinic client (pet parent). Each client can have multiple email
        addresses.
      operationId: client_email_addresses_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: >-
            When provided, filters to email addresses for the clinic with this
            ID.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              When provided, filters to email addresses for the clinic with this
              ID.
            title: Clinic Id
        - description: Filters to email addresses for the clinic client with this ID.
          in: query
          name: clinic_client_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Filters to email addresses for the clinic client with this ID.
            title: Clinic Client Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalClientEmailAddressSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalClientEmailAddressSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalClientEmailAddressSchema'
          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: ExternalClientEmailAddressSchemaList
      type: object
    ExternalClientEmailAddressSchema:
      properties:
        client_id:
          description: The ID of the clinic client this email address belongs to.
          title: Client Id
          type: integer
        client_user_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The ID of the client user this email address is tied to.
          title: Client User Id
        clinic_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The ID of the clinic this email address belongs to.
          title: Clinic Id
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        deleted:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The datetime this record was soft deleted.
          title: Deleted
        email:
          description: The email address string.
          title: Email
          type: string
        external_contact_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The ID of the external contact this email address is tied to.
          title: External Contact Id
        id:
          description: The ID of the client email address record.
          title: Id
          type: integer
        is_deleted:
          description: Whether this record is soft deleted or not.
          title: Is Deleted
          type: boolean
        is_email_unsubscribed:
          description: >-
            Whether the client has unsubscribed from marketing emails for this
            email address.
          title: Is Email Unsubscribed
          type: boolean
        last_verified_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Timestamp of the last deliverability verification attempt.
          title: Last Verified At
        marked_undeliverable_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: When this email address was marked as undeliverable, if at all.
          title: Marked Undeliverable At
        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
      required:
        - created
        - modified
        - is_deleted
        - deleted
        - id
        - client_id
        - client_user_id
        - external_contact_id
        - clinic_id
        - email
        - marked_undeliverable_at
        - last_verified_at
        - is_email_unsubscribed
      title: ExternalClientEmailAddressSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````