---
title: "List animals for a Link customer"
method: GET
path: "/workspaces/{workspaceId}/link/customers/{customerId}/animals"
tags: ["link"]
---

# List animals for a Link customer

`GET /workspaces/{workspaceId}/link/customers/{customerId}/animals`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/workspaces/{workspaceId}/link/customers/{customerId}/animals`
- Auth: HTTP bearer

Lists active animals (not deceased, removed or marked duplicate) owned by the given Link customer, most recently updated first. Only the first 100 animals are returned and there is no pagination metadata; prefer the paginated `/animals/page` variant, which also supports a name filter.

## Path parameters

- `workspaceId` string, required: Identifier of the clinic (workspace), as returned by `GET /workspaces`. The key's user must be a member of the clinic, or an admin of the organization it belongs to.
- `customerId` integer, required: Link customer (animal owner) id, as returned in `customers[].id` by the customer search endpoint.

## Response `200`

Array of animals.

- LinkAnimal[]
  - `id` integer, required: Link animal id. Pass it as `animalId` to the compatible-entries and export endpoints.
  - `name` string, required: Animal name from Link.
  - `kindName` string, nullable, required: Species name from Link (Link calls it kind), or `null`.
  - `breedName` string, nullable, required: Breed name from Link, or `null`.
  - `genderName` string, nullable, required: Sex name from Link, or `null`.
  - `birthdate` string, nullable, required: Date of birth (YYYY-MM-DD) from Link, or `null`.
  - `deceased` boolean, required: Whether Link marks the animal as deceased. Only active animals are requested from Link, so this is normally `false`.

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