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

# List all client communication numbers

`GET /ext/v2/client-communication-numbers/`

## Request

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

Returns a list of all client communication numbers across all clinics in the organization. The communication numbers 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 communication number** represents a phone number associated with a clinic client (pet parent). Each client can have multiple phone numbers.

## 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 phone numbers for the clinic with this ID.
- `clinic_client_id` integer, nullable: Filters to phone numbers for the clinic client with this ID.

## Response `200`

OK

- ExternalClientCommunicationNumberSchemaList
  - `data` ExternalClientCommunicationNumberSchema[], required: A single page of data contained within this list.
    - `client_id` integer, required: The ID of the clinic client this phone number belongs to.
    - `client_user_id` integer, nullable, required: The ID of the client user this phone number is tied to.
    - `clinic_id` integer, nullable, required: The ID of the clinic this phone number belongs to.
    - `created` string, date-time, required: The datetime this object was created.
    - `custom_kind` string, nullable, required: Custom label for the phone number kind.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `external_contact_id` integer, nullable, required: The ID of the external contact this phone number is tied to.
    - `id` integer, required: The ID of the client communication number record.
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `kind` string, nullable, required: The kind of phone number (e.g. Mobile, Home, Work, Other).
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `phone_number` integer, required: The phone number as an integer.
    - `sms_enabled` boolean, required: Whether this phone number can receive SMS messages.
    - `sms_preference` 'NA' | 'ALL' | 'TRANSACTIONAL' | 'UNSUBSCRIBED', required
    - `verified_at` string, date-time, nullable, required: When the client verified access to this phone number, if at all.
  - `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)