GET /api/v1/agenda
Turnos de la clínica entre dos días (por defecto, hoy), hasta 31 días.
Requiere el permiso «Agenda».
from:- primer día, AAAA-MM-DD.
to:- último día, AAAA-MM-DD.
Para desarrolladores
Cada clínica puede dar acceso de solo lectura a sus datos a otras herramientas o a una inteligencia artificial, con claves propias que se pueden revocar en cualquier momento.
El acceso por API y MCP es un servicio adicional, con costo mensual, que se habilita por clínica. Para activarlo hay que escribir a [email protected].
Cada clave tiene permisos por tema, todos de solo lectura:
No hay acceso a historias clínicas, adjuntos, notas de Nia ni facturación, y ninguna consulta modifica datos.
Todas las consultas son GET y devuelven JSON. Los parámetros van en la dirección. Los importes están en centavos y las fechas son AAAA-MM-DD en la zona horaria de la clínica.
curl -H "Authorization: Bearer nv_…" "https://niavet.com/api/v1/agenda?from=2026-11-24&to=2026-11-25"GET /api/v1 devuelve la clínica a la que pertenece la clave, sus permisos y las consultas que puede hacer.
El servidor MCP está en /api/mcp (HTTP, JSON-RPC, sin sesión) y ofrece las mismas consultas como herramientas de solo lectura. Sirve para clientes que permiten enviar un encabezado propio, como Claude Desktop, Claude Code o Cursor. Configuración de ejemplo:
{
"mcpServers": {
"niavet": {
"url": "https://niavet.com/api/mcp",
"headers": {
"Authorization": "Bearer nv_…"
}
}
}
}Los conectores que piden OAuth en lugar de una clave (como los de claude.ai) se conectan solo con la dirección del servidor MCP: un propietario de la clínica inicia sesión, elige la clínica y los permisos, y autoriza. Puede revocar la conexión en cualquier momento desde Configuración. El acceso dura una hora y se renueva solo.
Estas son las consultas disponibles. En MCP tienen el mismo nombre y los mismos parámetros.
GET /api/v1/agendaTurnos de la clínica entre dos días (por defecto, hoy), hasta 31 días.
Requiere el permiso «Agenda».
from: to: GET /api/v1/patientsPacientes por nombre, microchip o nombre del tutor, de a 25 por página.
Requiere el permiso «Pacientes».
q: page: GET /api/v1/patientFicha administrativa de un paciente, sin historia clínica ni notas.
Requiere el permiso «Pacientes».
id (obligatorio): GET /api/v1/guardiansTutores por nombre, email o teléfono, con su contacto y cuántas mascotas tienen.
Requiere el permiso «Tutores».
q: page: GET /api/v1/vaccines_dueVacunas y desparasitaciones vencidas o que vencen en los próximos 30 días, con el paciente y el tutor.
Requiere el permiso «Vacunas».
filter: page: GET /api/v1/stockProductos con su existencia y precio de venta. Puede listar solo los que están por reponer.
Requiere el permiso «Stock».
q: restock_only: page: GET /api/v1/sales_summaryResumen de ventas de un período (por defecto, los últimos 30 días): total, cantidad, promedio, cobrado por medio de pago, más vendidos y deuda de tutores.
Requiere el permiso «Ventas».
from: to: {
"error": {
"code": "scope_missing",
"message": "Esta clave no tiene el permiso «stock»."
}
}