Guides
Appointments
How to retrieve calendar events via the Vetigen API.
Appointments Guide
Read calendar events for a clinic. Calendar endpoints require the clinic.calendar.view permission.
List Calendar Events
Retrieve appointments within a date range.
curl "https://api.vetigen.com/api/v1/calendar/events?start_date=2026-04-01T00:00:00Z&end_date=2026-04-30T23:59:59Z" \
-H "X-API-Key: sk_live_YOUR_KEY"Query Parameters
| Parameter | Type | Description |
|---|---|---|
start_date | ISO 8601 | Filter events starting from this date |
end_date | ISO 8601 | Filter events ending before this date |
type | string | Filter by event type |
status | string | Filter by event status |
Response
[
{
"fp": "calevt_01JQMKXXXXX",
"title": "Annual Checkup — Luna",
"type": "CHECKUP",
"status": "SCHEDULED",
"start_at": "2026-04-15T07:00:00.000Z",
"end_at": "2026-04-15T07:30:00.000Z",
"patient_fp": "patient_01JQMKXXXXX",
"assigned_user_fp": "user_01JQMKXXXXX"
}
]Event Types
| Type | Description |
|---|---|
APPOINTMENT | Standard veterinary appointment |
SURGERY | Surgical procedure |
VACCINATION | Vaccination session |
CHECKUP | Routine checkup |
EMERGENCY | Emergency visit |
SALE | Product/service sale |
Event Statuses
| Status | Description |
|---|---|
SCHEDULED | Appointment is confirmed |
CHECKED_IN | Patient has arrived |
IN_PROGRESS | Examination in progress |
PENDING_CHECKOUT | Awaiting payment/discharge |
CLOSED | Visit completed |
CANCELLED | Appointment was cancelled |