GET /api/v1/agenda
The clinic's appointments between two days (today by default), up to 31 days.
Requires the “Calendar” permission.
from:- first day, YYYY-MM-DD.
to:- last day, YYYY-MM-DD.
For developers
Each clinic can give other tools or an AI read-only access to its data, with its own keys that can be revoked at any time.
API and MCP access is an additional service, with a monthly cost, enabled per clinic. To activate it, write to [email protected].
Each key has permissions by topic, all of them read-only:
There is no access to medical records, attachments, Nia notes or invoicing, and no query changes any data.
All queries are GET and return JSON. Parameters go in the URL. Amounts are in cents and dates are YYYY-MM-DD in the clinic's time zone.
curl -H "Authorization: Bearer nv_…" "https://niavet.com/api/v1/agenda?from=2026-11-24&to=2026-11-25"GET /api/v1 returns the clinic the key belongs to, its permissions and the queries it can make.
The MCP server is at /api/mcp (HTTP, JSON-RPC, no session) and offers the same queries as read-only tools. It works with clients that let you send your own header, such as Claude Desktop, Claude Code or Cursor. Example configuration:
{
"mcpServers": {
"niavet": {
"url": "https://niavet.com/api/mcp",
"headers": {
"Authorization": "Bearer nv_…"
}
}
}
}Connectors that ask for OAuth instead of a key (such as claude.ai ones) connect with just the MCP server address: a clinic owner signs in, chooses the clinic and the permissions, and authorizes. The connection can be revoked at any time in Settings. Access lasts one hour and renews itself.
These are the available queries. In MCP they have the same name and the same parameters.
GET /api/v1/agendaThe clinic's appointments between two days (today by default), up to 31 days.
Requires the “Calendar” permission.
from: to: GET /api/v1/patientsPatients by name, microchip or client name, 25 per page.
Requires the “Patients” permission.
q: page: GET /api/v1/patientA patient's administrative record, with no medical record or notes.
Requires the “Patients” permission.
id (required): GET /api/v1/guardiansClients by name, email or phone, with their contact details and how many pets they have.
Requires the “Clients” permission.
q: page: GET /api/v1/vaccines_dueVaccinations and dewormings that are overdue or due in the next 30 days, with the patient and the client.
Requires the “Vaccines” permission.
filter: page: GET /api/v1/stockProducts with their quantity and selling price. It can list only those that need restocking.
Requires the “Stock” permission.
q: restock_only: page: GET /api/v1/sales_summarySales summary for a period (the last 30 days by default): total, count, average, collected by payment method, best sellers and client debt.
Requires the “Sales” permission.
from: to: {
"error": {
"code": "scope_missing",
"message": "This key does not have the “stock” permission."
}
}