Clinic clients

List all clinic clients

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

A clinic client represents a pet parent at a specific clinic location. Each clinic client belongs to exactly one clinic and can be associated with one or more clinic patients (pets). When the same person visits multiple clinics in the organization, they will have a separate clinic client record at each location, linked by a shared organization client ID.

GET

ext

clinic-clients

List all clinic clients

curl --request GET \
  --url https://connect.vetcove.com/ext/v2/clinic-clients/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://connect.vetcove.com/ext/v2/clinic-clients/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://connect.vetcove.com/ext/v2/clinic-clients/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.vetcove.com/ext/v2/clinic-clients/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://connect.vetcove.com/ext/v2/clinic-clients/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "can_be_called": true,
      "client_notes": "<string>",
      "clinic_id": 123,
      "created": "2023-11-07T05:31:56Z",
      "deleted": "2023-11-07T05:31:56Z",
      "external_id": "<string>",
      "has_multiple_users": true,
      "has_unread_messages_for_clinic": true,
      "id": 123,
      "is_active": true,
      "is_deleted": true,
      "is_email_unsubscribed": true,
      "is_subscribed": true,
      "last_visit_date": "2023-11-07T05:31:56Z",
      "modified": "2023-11-07T05:31:56Z",
      "organization_client_id": 123,
      "pim_id": "<string>",
      "primary_client_user_id": 123,
      "email": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "phone_number": 123,
      "primary_address": {
        "address_one": "<string>",
        "city": "<string>",
        "id": 123,
        "state": "<string>",
        "zipcode": "<string>",
        "address_two": "",
        "country": "US",
        "county": "",
        "name": "",
        "phone_number": 123
      },
      "primary_payment_method_id": 123
    }
  ],
  "next_page": "<string>",
  "has_more": false,
  "type": "list"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ids

integer[] | null

When provided, filters to objects with these IDs.

ending_before

integer | null

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

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

default:10

The maximum number of items to return per page.

Required range: 1 <= x <= 100

cursor

string | null

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

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

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

enum<string>

default:FALSE

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.

Available options:

FALSE,

TRUE,

ALL

clinic_id

integer | null

Filters to clients for the clinic with this ID.

organization_client_id

integer | null

Filters to clients associated with the organization client ID.

string | null

When provided, filters to clients with this exact email address

phone_number

integer | null

When provided, filters to clients with this exact 10-digit phone number

Required range: 1000000000 <= x <= 9999999999

Response

200 - application/json

data

ExternalClinicClientSchema · object[]

required

A single page of data contained within this list.

Show child attributes

next_page

string

required

A URL linking to the next page of this list.

has_more

boolean

default:false

Whether there are more pages or data in this list.

type

string

default:list

Type of this object. Always list.

⌘I

List all clinic clients

curl --request GET \
  --url https://connect.vetcove.com/ext/v2/clinic-clients/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://connect.vetcove.com/ext/v2/clinic-clients/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://connect.vetcove.com/ext/v2/clinic-clients/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.vetcove.com/ext/v2/clinic-clients/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://connect.vetcove.com/ext/v2/clinic-clients/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "can_be_called": true,
      "client_notes": "<string>",
      "clinic_id": 123,
      "created": "2023-11-07T05:31:56Z",
      "deleted": "2023-11-07T05:31:56Z",
      "external_id": "<string>",
      "has_multiple_users": true,
      "has_unread_messages_for_clinic": true,
      "id": 123,
      "is_active": true,
      "is_deleted": true,
      "is_email_unsubscribed": true,
      "is_subscribed": true,
      "last_visit_date": "2023-11-07T05:31:56Z",
      "modified": "2023-11-07T05:31:56Z",
      "organization_client_id": 123,
      "pim_id": "<string>",
      "primary_client_user_id": 123,
      "email": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "phone_number": 123,
      "primary_address": {
        "address_one": "<string>",
        "city": "<string>",
        "id": 123,
        "state": "<string>",
        "zipcode": "<string>",
        "address_two": "",
        "country": "US",
        "county": "",
        "name": "",
        "phone_number": 123
      },
      "primary_payment_method_id": 123
    }
  ],
  "next_page": "<string>",
  "has_more": false,
  "type": "list"
}

Using the API

Developer guides

Accounts

Care plans

Catalog

Checkout links

Clients & patients

Clinics

External Rx

Insurance

Inbox

Invoices

Labs

Onboardings

Orders

Payments

PDFs

Prescriptions

Scheduler

Service pricing

Standard care

Subscriptions

File uploads

Inventory

Forms

Medical records

List all clinic clients

Authorizations

Query Parameters

Response