---
title: "List all client email addresses"
method: GET
path: "/ext/v2/client-email-addresses/"
tags: ["Inbox"]
---

# List all client email addresses

`GET /ext/v2/client-email-addresses/`

## Request

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

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.

## 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: When provided, filters to email addresses for the clinic with this ID.
- `clinic_client_id` integer, nullable: Filters to email addresses for the clinic client with this ID.

## Response `200`

OK

- ExternalClientEmailAddressSchemaList
  - `data` ExternalClientEmailAddressSchema[], required: A single page of data contained within this list.
    - `client_id` integer, required: The ID of the clinic client this email address belongs to.
    - `client_user_id` integer, nullable, required: The ID of the client user this email address is tied to.
    - `clinic_id` integer, nullable, required: The ID of the clinic this email address belongs to.
    - `created` string, date-time, required: The datetime this object was created.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `email` string, required: The email address string.
    - `external_contact_id` integer, nullable, required: The ID of the external contact this email address is tied to.
    - `id` integer, required: The ID of the client email address record.
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `is_email_unsubscribed` boolean, required: Whether the client has unsubscribed from marketing emails for this email address.
    - `last_verified_at` string, date-time, nullable, required: Timestamp of the last deliverability verification attempt.
    - `marked_undeliverable_at` string, date-time, nullable, required: When this email address was marked as undeliverable, if at all.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
  - `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)