---
title: "Conceptos"
description: "Cómo está organizada la API de Arbol y las reglas que comparten todas las llamadas."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos

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](/developers/integrations/) 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 usan `POST`.
- **Nombres de operación.** Cada operación se llama `<service>.<resource>.<verb>`, como `account.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 en `https://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](/developers/authentication/).

## 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.

Source: https://docs.getarbol.com/developers/concepts/index.mdx