Guides
Patients
How to list, search, and retrieve patient records via the Vetigen API.
Patients Guide
Manage patient (pet) records through the Vetigen API. All patient endpoints require the patients:read scope.
List Patients
Retrieve a paginated list of patients accessible to your clinic.
curl https://api.vetigen.com/api/v1/patients \
-H "Authorization: Bearer sk_live_YOUR_KEY"Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
page_size | integer | Items per page (default: 20, max: 100) |
search | string | Search by patient name or owner name |
species | string | Filter by species (e.g., cat, dog) |
Response
{
"success": true,
"data": {
"items": [
{
"fp": "patient_01JQMKXXXXX",
"name": "Luna",
"species": "cat",
"breed": "British Shorthair",
"gender": "female",
"birth_date": "2021-03-15",
"color": "grey",
"owner": {
"fp": "customer_01JQMKXXXXX",
"name": "Jane Doe",
"phone": "+905551234567"
},
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 42,
"page": 1,
"page_size": 20,
"has_more": true
}
}Get a Patient
Retrieve a specific patient by their fingerprint (fp).
curl https://api.vetigen.com/api/v1/patients/patient_01JQMKXXXXX \
-H "Authorization: Bearer sk_live_YOUR_KEY"Response
{
"success": true,
"data": {
"fp": "patient_01JQMKXXXXX",
"name": "Luna",
"species": "cat",
"breed": "British Shorthair",
"gender": "female",
"birth_date": "2021-03-15",
"weight_kg": 4.2,
"microchip": "956000012345678",
"owner": {
"fp": "customer_01JQMKXXXXX",
"name": "Jane Doe",
"phone": "+905551234567",
"email": "jane@example.com"
},
"clinic": {
"fp": "clinic_01JQMKXXXXX",
"name": "Downtown Vet Clinic"
},
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2026-03-20T14:22:00Z"
}
}Error Responses
Patient not found
{
"success": false,
"error": {
"code": "PATIENT.NOT_FOUND",
"message": "No patient found with the given fingerprint.",
"severity": "error"
}
}