Guides
Patients
How to list and retrieve patient records via the Vetigen API.
Patients Guide
Read patient records through the Vetigen API. Patient endpoints require the clinic.patient.view permission.
List Patients
Retrieve a paginated list of patients accessible to your clinic.
curl https://api.vetigen.com/api/v1/patients \
-H "X-API-Key: sk_live_YOUR_KEY"Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
page_size | integer | Items per page |
status | string | Filter by patient status |
customer_fp | string | Filter by owner customer fingerprint |
Response
{
"success": true,
"data": {
"items": [
{
"fp": "patient_01JQMKXXXXX",
"name": "Luna",
"species": "cat",
"breed": "British Shorthair",
"sex": "female",
"date_of_birth": "2021-03-15",
"owner_customer_fp": "customer_01JQMKXXXXX",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2026-03-20T14:22:00Z"
}
],
"total": 42,
"page": 1,
"page_size": 20,
"has_more": true
},
"message": "OK"
}Get a Patient
Retrieve a specific patient by fingerprint.
curl https://api.vetigen.com/api/v1/patients/patient_01JQMKXXXXX \
-H "X-API-Key: sk_live_YOUR_KEY"Response
{
"success": true,
"data": {
"fp": "patient_01JQMKXXXXX",
"name": "Luna",
"species": "cat",
"breed": "British Shorthair",
"sex": "female",
"date_of_birth": "2021-03-15",
"weight_kg": 4.2,
"owner_customer_fp": "customer_01JQMKXXXXX",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2026-03-20T14:22:00Z"
},
"message": "OK"
}Error Responses
Patient not found
{
"success": false,
"error": {
"code": "PATIENT.NOT_FOUND",
"message": "Patient with fingerprint patient_... does not exist.",
"severity": "error"
}
}