---
title: "List clients (owners)"
method: GET
path: "/workspaces/{workspaceId}/clients"
tags: ["clients"]
---

# List clients (owners)

`GET /workspaces/{workspaceId}/clients`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/workspaces/{workspaceId}/clients`
- Auth: HTTP bearer

Returns every client (owner) in the workspace in one unpaginated response, in no guaranteed order, including the empty placeholder owners created with patients that had no owner details. Clients do not embed their patients; search the patient list by the owner's name to find them (each patient carries `clientId`).

## Path parameters

- `workspaceId` string, required: Identifier of the workspace (clinic) that owns the patients and clients. The caller must be a member of it; patients and clients are shared by all members of the workspace.

## Response `200`

List of all clients in the workspace.

- ClientList: All clients (owners) in a workspace, unpaginated.
  - `clients` ClientOutput[], required: Every client in the workspace, including empty placeholder owners, in no guaranteed order.
    - `id` string, required: Client id (UUID), generated by Vetnio.
    - `name` string, nullable, required: The owner's full name, free text. `null` when not recorded, for example for the placeholder owner created with a patient that had no owner details.
    - `address` string, nullable, required: The owner's street address, free text. `null` when not recorded.
    - `zipCode` string, nullable, required: The owner's postal code, free text. `null` when not recorded.
    - `phoneNumbers` string[], required: The owner's phone numbers, stored as given (no normalisation). E.164 format such as `+46701234567` is recommended. Empty array when none are recorded.
    - `email` string, nullable, required: The owner's email address. Stored as given; the format is not validated. `null` when not recorded.

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/vetnio/apis/vetnio-api.md) - [All operations](https://skmtc.dev/vetnio/apis/vetnio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vetnio/apis/vetnio-api/revisions/d004afd5617d?raw)