La API de Arbol es un solo host, https://api.getarbol.com, con varios servicios: los productos de Arbol (Raíz, Agenda, Cuenta) y las integraciones con aseguradoras, registros y sistemas clínicos. Sea cual sea el servicio, una llamada sigue las mismas reglas, que se describen en estas páginas.
Cómo está organizada la API
- Rutas. Las operaciones de cada servicio viven bajo
/v1/<service>/, como/v1/account/organization. Toma el método y la ruta de la referencia de la API: no siempre reflejan el nombre de la operación, y algunas lecturas usanPOST. - Nombres de operación. Cada operación se llama
<service>.<resource>.<verb>, comoaccount.organization.get. La referencia de la API, los SDK y las herramientas MCP llevan ese nombre. - OpenAPI. Toda la API se describe en
https://api.getarbol.com/openapi.json, y cada servicio enhttps://api.getarbol.com/v1/<service>/openapi.json. Ambos son públicos.GET https://api.getarbol.com/los lista. - Credenciales. Cada llamada lleva una credencial en el encabezado
Authorization. Consulta Autenticación.
Las reglas que comparten todas las llamadas
Organizaciones
Cada credencial actúa en una organización. Quién puede llamar y con qué permisos.
Respuestas y errores
El envoltorio de respuesta, los códigos de error, los ids de solicitud y los límites de tamaño.
Paginación
Cómo las operaciones de lista devuelven una página a la vez, con cursores.
Reintentos
Qué llamadas es seguro repetir y cómo manejar una escritura cuyo resultado no se conoce.
Versiones y actualizaciones
Qué pasa cuando la API cambia y cuándo se actualizan el SDK, la CLI, MCP y esta documentación.