---
title: "Search VetManager patients"
method: GET
path: "/workspaces/{workspaceId}/vetmanager/patients"
tags: ["vetmanager"]
---

# Search VetManager patients

`GET /workspaces/{workspaceId}/vetmanager/patients`

## Request

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

Searches the caller's VetManager practice by animal name and owner surname and returns animal and owner pairs. Read-only: nothing is created in Vetnio or VetManager.

Errors: `400` for a query shorter than 3 characters; `401` when the caller has no linked VetManager account or must sign in again; `403` when the practice is not linked to this workspace or VetManager has not enabled search for it.

## Path parameters

- `workspaceId` string, required: Identifier of the Vetnio workspace (clinic). The caller must be a member. Patient and visit endpoints also require the workspace to be linked to the caller's VetManager practice.

## Query parameters

- `query` string, required: Animal name or owner surname to search for in VetManager. 3 to 200 characters after trimming.

## Response `200`

Matching animals.

- object: Animals matching the query by animal name or owner surname.
  - `patients` object[], required: At most 20 matches, animal-name matches first.
    - `contactId` integer, required: VetManager client (owner) id.
    - `animalId` integer, required: VetManager animal id.
    - `animalName` string, nullable, required: Animal name, or `null` when VetManager has none.
    - `animalKind` string, nullable, required: Animal kind as VetManager names it (Swedish).
    - `ownerName` string, nullable, required: Owner name. `null` when the match came only from the animal search, which returns no owner names.
    - `customerNumber` string, nullable, required: The practice's customer number for the owner, when known.
    - `patientId` string, nullable, required: Vetnio patient already created from this animal in the workspace, or `null`.

## 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)