/v1 pensada para integraciones del lado del servidor: un ERP o sistema de compras, una herramienta de BI, una hoja de cálculo automatizada, un tablero interno. Se autentica con una clave de API que pertenece a una sola clínica dental y lee los mismos datos con los que tu equipo trabaja en la consola.
La API es de solo lectura, con una excepción: POST /v1/analytics/exports, que pide a muveya generar un archivo CSV del resumen gerencial. Nada de lo que llames en /v1 crea, cambia ni elimina un pedido, una caja, un movimiento de existencias, un miembro o un insumo del catálogo.
URL base
/v1, así que tu primera llamada es https://api.muveya.com/v1/me.
Autenticación en una línea
Palabras de la consola y palabras de la API
La consola y la API describen lo mismo con palabras distintas. Tenlas presentes al relacionar los datos de la API con lo que las personas ven en pantalla.Qué cubre /v1
Cada scope se explica en Scopes. La solicitud y la respuesta de cada operación están documentadas en el grupo Endpoints de esta pestaña.
Qué no hace /v1
- No crea ni cambia nada de tu operación: pedidos, aprobaciones, preparación, despacho, entrega, recepción, ingresos de existencias, consumos, traslados, correcciones, conteos, cambios de catálogo y cambios del equipo se hacen en la consola (consulta Introducción), y algunas tareas de existencias desde WhatsApp (consulta Canal de WhatsApp).
- No crea ni revoca claves de API. Consulta Autenticación.
- No envía eventos a tus sistemas. Todavía no hay webhooks; consulta Webhooks para saber cómo consultar periódicamente.
- Nunca devuelve totales de pedidos ni referencias de pacientes (consulta Datos que se omiten).
Convenciones
JSON en todo. Las respuestas exitosas sonapplication/json. Los errores son documentos application/problem+json con un code estable (consulta Errores). Los nombres de campos están en inglés con formato camelCase y los valores de enumeraciones son palabras en inglés en minúsculas, como pending_approval; las claves de métricas van en mayúsculas, como LOW_STOCK. Ninguno cambia con el idioma.
Ids opacos. Todos los ids son cadenas de texto. Compáralos como texto y nunca los interpretes ni los construyas. Un id que pertenece a otra clínica dental se comporta exactamente igual que un id inexistente: la respuesta es 404.
Ausente, no null. Un campo opcional sin valor, o que tu clave no puede ver, se omite de la respuesta. No se envía como null ni como 0. Las excepciones son tres campos de analítica: value (de una métrica o de una cifra del resumen) y averageHours (de una etapa del tiempo de ciclo) son null cuando no hubo muestra para medir, y maxAgeHours es null en el tramo abierto de los pendientes de aprobación.
Fechas en UTC. Las fechas y horas son cadenas ISO 8601 en UTC con el sufijo Z, por ejemplo 2026-09-15T13:45:00.000Z. Los reportes de analítica indican "timezone": "UTC". Las ventanas de tiempo que envías (from, to) también van en ISO 8601.
Dinero en unidades menores. Un importe es un entero en la unidad menor de su moneda (centavos para USD) y siempre viaja con currency, un código ISO 4217: "cost": 1250, "currency": "USD" significa 12,50 USD. El dinero solo aparece en los campos de costo del catálogo y en el unitCost de las líneas de pedido, y solo para una clave con catalog.cost:read.
Cantidades en la unidad del insumo. Cantidades como onHand, requestedQty o quantityDelta son enteros contados en la unitOfMeasure del insumo (unit, box, milliliter, etc.). La API nunca suma cantidades de insumos o unidades distintas.
Idioma. Envía Accept-Language con en, es o pt (el inglés es el valor por defecto). Solo cambia el texto pensado para personas: el title y el detail de un error, la label de cada cifra del resumen gerencial y las etiquetas dentro de una exportación CSV. Claves, códigos, valores de enumeraciones, números e ids son iguales en todos los idiomas.
Ids de solicitud. Toda respuesta incluye el encabezado x-request-id. Si envías tu propio X-Request-Id con un UUID, muveya lo reutiliza; si no, genera uno. Los cuerpos de error lo repiten como requestId. Regístralo en tu sistema e inclúyelo cuando escribas a team@muveya.com.
Listas. Toda lista responde { "data": [...], "hasMore": false }, más nextCursor cuando hay otra página. Consulta Paginación.
Límites de uso. Cada clave tiene su propio presupuesto de solicitudes y cada respuesta lo informa en encabezados. Consulta Límites de uso.
Estabilidad. Dentro de /v1 los cambios son aditivos. Consulta Versionado y estabilidad y Novedades.
Datos que se omiten
El servidor quita los datos que tu clave no puede ver antes de construir la respuesta. Los campos se omiten, nunca se enmascaran.
Una clave de API no es un miembro del equipo y no está limitada por el acceso a sedes: lee todas las sedes y bodegas de su clínica dental dentro de sus scopes. Da a cada clave solo los scopes que la integración necesita.
Cómo está organizada esta referencia
- Resumen (estas páginas): autenticación, guía rápida, scopes, paginación, límites de uso, errores, versionado, exportaciones y webhooks.
- Endpoints: una página por operación, generada a partir del contrato OpenAPI de muveya, en tu idioma. Cada página muestra los parámetros, el esquema de respuesta, los errores posibles y ejemplos de solicitud en cURL, JavaScript y Python. El constructor de solicitudes de esas páginas solo prepara una solicitud para que la copies: nunca la envía y nunca guarda tu clave.
El servidor MCP en
https://api.muveya.com/mcp usa ingreso y autorización con OAuth para asistentes de IA. Consulta Servidor MCP.Autenticación
Obtén una clave, envíala y mantenla en tu servidor.
Guía rápida
Tus primeras llamadas con cURL, JavaScript y Python.
Scopes
Qué permite leer cada scope.
Errores
El documento de problema y todos los códigos de error.