API reference

The basics

• Base URLhttps://api.getarbol.com/v1/<service>Each service below has its own path, such as /v1/raiz or /v1/sura.
• AuthenticationAuthorization: Bearer <token>An API key or an OAuth access token. One credential works for every service. Get an API key
• Responses{ success, data, error, metadata }JSON in the same envelope whether the call succeeds or fails. Responses and errors

Your first request: the organization your API key belongs to.

curl https://api.getarbol.com/v1/account/organization \
  --header "Authorization: Bearer $ARBOL_API_KEY"

• TypeScriptnpm install @arbol-ai/sdk
• Rustarbol-sdk (git dependency)
• CLInpm install --global @arbol-ai/cli
• MCPhttps://api.getarbol.com

Products

Patient contact, scheduling and the organization itself.

• Raíz66 endpoints

  Contact with each patient: agents and their voices, channels, campaigns, templates and bulletins, conversations, contacts and profiles, the block list, knowledge, facts and definitions, tasks, evaluations and reports.

  ReferenceOpenAPI/v1/raiz

• Agenda34 endpoints

  Scheduling: services and offerings, resources and locations, schedule rules, appointments, bookings and the waitlist.

  ReferenceOpenAPI/v1/agenda

• Account29 endpoints

  The organization: members and invitations, API keys, connections, roles and permissions, billing, invoices and usage.

  ReferenceOpenAPI/v1/account

Integrations

Insurers, public registries and clinical systems, through your organization's connections to them. How integrations work

• SURA12 endpoints

  Eligibility, patients, services, professionals, availability, appointments, authorizations and copays through your SURA connections.

  ReferenceOpenAPI/v1/sura

• Nueva EPS1 endpoint

  Member affiliation lookups through your Nueva EPS connections.

  ReferenceOpenAPI/v1/nueva-eps

• gMedic23 endpoints

  Patients and patient notes, agendas, availability and appointments, sessions, branch offices and reference lists from gMedic.

  ReferenceOpenAPI/v1/gmedic

• Visoft12 endpoints

  Clinics, contracts and services, professionals, patients, availability and appointments from Visoft.

  ReferenceOpenAPI/v1/visoft

• AXA3 endpoints

  Beneficiary eligibility, medical authorizations and the provider profile from AXA.

  ReferenceOpenAPI/v1/axxa

• Salud Total5 endpoints

  Member affiliation, authorization and filing records, invoices and objection notices through your Salud Total IPS connections.

  ReferenceOpenAPI/v1/salud-total

• ADRES1 endpoint

  A person and every EPS affiliation they have, from Colombia's national affiliate database.

  ReferenceOpenAPI/v1/adres

• Policía Colombia1 endpoint

  The judicial statement the Colombian National Police publish for a document, word for word.

  ReferenceOpenAPI/v1/policia-colombia

• Sisbén1 endpoint

  A person's Sisbén IV registration, with its official group and subgroup.

  ReferenceOpenAPI/v1/sisben

OpenAPI

Machine-readable specs for your tools. This reference matches API release 1.20261104.21009.

• One servicehttps://docs.getarbol.com/api/<service>/openapi.jsonImport it into Postman or Insomnia, or generate a client. No credential needed.
• The whole APIhttps://api.getarbol.com/openapi.jsonEvery service in one document, as the API serves it.
• API cataloghttps://docs.getarbol.com/.well-known/api-catalogEach reference with its docs and OpenAPI document (RFC 9727), for tools and AI agents.