Veterical Vet Clinic

Use this when someone asks to book an animal in for a visit at their vet clinic. Returns the new appointment with its time, provider ids and procedure count; it takes the clinic's usual length and reminders, so the clinic's reminder messages go to the animal's owner. Not for vaccinations, which are booked in Veterical.

Use this when someone asks to cancel an animal's appointment or decline one an owner requested. Returns the appointment as canceled, kept rather than deleted, and whether the clinic's cancellation message goes to the owner. Not for moving an appointment to another time.

Use this when someone asks to add a new pet owner to their vet clinic. Returns the owner's id, name, clinic and language; the phone and email given are saved but never returned. Not for adding an animal.

Use this when someone asks to add a new animal to their vet clinic, such as a new puppy of an existing owner. Returns the animal's id, name and clinic; it is saved with its species, breed and owner. Not for adding a pet owner.

Use this when someone names a pet owner of their vet clinic, to get the owner's id before adding an animal or changing their details. Returns up to five owners whose name contains every word given, with id, name and clinic; namesakes are told apart by the last two digits of their phone. Not for finding an animal.

Use this when someone names an animal of their vet clinic, to get its id before booking it or changing its details. Returns up to five animals whose name contains every word given, with id, name and clinic; namesakes are told apart by the last two digits of the owner's phone. Not for browsing animals or reading an animal's history, records or vaccinations.

Use this when the user wants to read the name, currency, language, timezone and edit time of one Veterical clinic selected by its identifier. Returns the clinic's name, currency, default language, timezone and last edit time; an id outside the organization returns not-found. Not for free appointment slots.

Use this when the user wants to summarize unassigned online-booking capacity for one Veterical clinic as daily slot counts and first/last slot times. Returns the open online-booking slots per day for one clinic: how many, plus the first start and last end time. Covers the next days that have openings, up to 14 days and 100 slots (no pet, owner or medical data). Not for booking an appointment.

Use this when the user wants to count scheduled records by UTC day for one Veterical clinic and a bounded date range, including canceled records. Returns appointment counts per UTC day for one clinic, canceled ones included, for the next 7 days by default and at most 31 days; counting stops at 100. Not for seeing individual appointments, pets or owners.

Use this when someone asks when an animal is booked or what is booked on one day, including to move or cancel an appointment. Returns up to 100 appointments of one animal or one day, with id, animal, clinic and provider ids, times, status and edit time. Not for counting how busy each day is.

Use this when the user wants to list non-appointment calendar blocks and additional opening periods for a Veterical clinic. Returns each block or extra opening with start, end, all-day flag, scope (clinic, staff or room) and type, without titles, notes or names. Not for appointments.

Use this when the user wants to know which vets, nurses or assistants a Veterical clinic has, or needs their ids to book with one. Returns up to 100 staff with id and display name for one clinic (no contact details, roles or pet data). Not for staff days off or vacations.

Use this when the user wants to list veterinary clinics accessible to the connected Veterical account and retrieve their identifiers for subsequent administrative reads. Returns each clinic's id, name, currency, default language and timezone, 20 per page by default. Not for finding a pet, owner or appointment.

Use this when someone asks how much of a medicine, product or supply is left in their vet clinic's stock or what is running low. Returns up to 100 stock items with unit, quantity, minimum and a low-stock flag. Not for procedure prices.

Use this when the user wants to aggregate one bounded page of recorded Veterical payments by currency and status; this is not a full revenue or settlement report. Returns totals and counts by currency and status for one page of payments, newest first (20 by default), with a cursor for the rest (no client, pet or card data). Not for refunds or charging a client.

Use this when someone asks what their vet clinic's procedures cost or how long they take, or needs procedure ids to book one. Returns the clinic's procedures with id, name, price, duration and whether each is a vaccine, which only Veterical itself books. Not for an animal's treatment history.

Use this when the user wants to read the subscription plan, status, billing frequency and configured capacity limits for a Veterical clinic. Returns plan name, status, billing frequency and plan caps per subscription; caps are limits, not usage. Not for invoices or amounts billed.

Use this when the user wants to open the Veterical clinic-selection sidebar when the user requests an interactive clinic browser. Returns up to 100 clinics to start from (no pet, owner, appointment or clinical data). Not for booking appointments, editing records or medical decisions.

Use this when someone asks to move an animal's appointment to another day or time. Returns the moved appointment; its animal, providers, procedures and length stay the same and the owner's reminders move with it. Not for cancelling an appointment.

Use this when someone asks to correct or update how much of a stock item their vet clinic has. Returns the item with its previous and new quantity; the number given replaces the stored one. Not for adding a new stock item.

Use this when the user wants to render a read-only administrative overview for one Veterical clinic selected by its identifier. Returns an overview card with the clinic's details, appointment counts for the next 7 days, how many staff can be booked, open online-booking slots and up to 12 catalog prices (no pet, owner or medical data). Not for a single appointment.

Use this when someone asks to change a pet owner's name, phone, email or language. Returns the owner's id, name, clinic and which fields changed; contact details are never returned. Not for changing an animal's details.

Use this when someone asks to rename an animal, correct its species or breed, or record its owner. Returns the animal's id, name, clinic and which fields changed. Not for adding a new animal.