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

# Inicio rápido: tu primera llamada a la API

> Crea una clave de API en Brelio y lista los servicios de tu clínica con un solo comando curl.

En dos minutos creas una clave de API de la organización y llamas a la API REST con ella.

**1. Crea una clave de API**

En Brelio, abre **Configuración › Integraciones › Claves de API** y pulsa **Nueva clave**. Ponle el nombre de la herramienta que la usará (por ejemplo «n8n»), marca **Ver servicios** y **Ver profesionales**, y créala.

Copia la clave ahora: Brelio solo la muestra una vez. Trátala como una contraseña: guárdala en un gestor de secretos o en una variable de entorno, nunca en el código.

> [!NOTE]
>
> Necesitas el permiso **Gestionar integraciones** en Brelio, y tu plan debe incluir el acceso a la API.

**2. Guárdala en tu terminal**

```bash theme={null}
export BRELIO_API_KEY="pega-aquí-tu-clave"
```

**3. Lista tus servicios**

```bash theme={null}
curl https://api.brelio.app/v1/services \
  -H "Authorization: Bearer $BRELIO_API_KEY"
```

La respuesta es una página de servicios:

```json Respuesta theme={null}
{
  "data": [
    {
      "id": "c3c8e275-a6b1-4fba-9b17-9c0a01e3ffc8",
      "name": "Fisioterapia",
      "description": null,
      "status": "active",
      "defaultDuration": 45,
      "color": null,
      "price": null,
      "createdAt": "2026-11-09T17:59:08.454Z",
      "updatedAt": "2026-11-09T17:59:08.454Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
```

**4. Mira los límites que lleva**

Cada respuesta lleva las cabeceras de [límites de uso](https://docs.brelio.com/es/concepts/rate-limits.md):

```bash theme={null}
curl -sS -D - -o /dev/null https://api.brelio.app/v1/services \
  -H "Authorization: Bearer $BRELIO_API_KEY"
```

```text Cabeceras de la respuesta theme={null}
HTTP/2 200
ratelimit-policy: "burst";q=100;w=10, "standard";q=600;w=60
ratelimit: "standard";r=599;t=52
x-request-id: 64461250-2749-41ee-9ce9-1e01c2529401
```

## La misma llamada en tu lenguaje

```bash curl theme={null}
curl https://api.brelio.app/v1/services?status=active \
  -H "Authorization: Bearer $BRELIO_API_KEY"
```

```javascript Node.js theme={null}
const response = await fetch('https://api.brelio.app/v1/services?status=active', {
  headers: { Authorization: `Bearer ${process.env.BRELIO_API_KEY}` },
})
if (!response.ok) throw new Error(JSON.stringify(await response.json()))
const { data } = await response.json()
for (const service of data) console.log(service.name, service.defaultDuration, 'min')
```

```python Python theme={null}
import os
import requests

response = requests.get(
    "https://api.brelio.app/v1/services",
    params={"status": "active"},
    headers={"Authorization": f"Bearer {os.environ['BRELIO_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
for service in response.json()["data"]:
    print(service["name"], service["defaultDuration"], "min")
```

## Si falla

| Respuesta | Por qué | Solución |
| - | - | - |
| `401 PLATFORM_UNAUTHENTICATED` | Falta la cabecera `Authorization`, o la clave es incorrecta o está revocada | Envía `Authorization: Bearer <clave>` con la clave completa. |
| `402 PLATFORM_PLAN_REQUIRED` | El plan de la clínica no incluye el acceso a la API | Un propietario lo añade en **Configuración › Suscripción**. |
| `403 OPERATION_FORBIDDEN` | A la clave le falta el permiso que indica `params.permission` | Crea una clave con ese permiso. |
| `403 DATA_AREA_OFF` | La clínica no deja que las integraciones usen esa área de datos | Consulta las [áreas de datos](https://docs.brelio.com/es/concepts/data-areas.md). |

Todos los códigos están explicados en [Errores](https://docs.brelio.com/es/concepts/errors.md).

## Siguiente paso

> [card] [Reserva una cita](https://docs.brelio.com/es/guides/book-appointment.md)
>
> Busca un hueco libre, resérvalo, reprográmalo y cancélalo.

> [card] [Autenticación](https://docs.brelio.com/es/authentication.md)
>
> Claves de la organización, claves personales, apps de partners y MCP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.