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

# Referencia del API

> Consultas y registros disponibles en la API de integraciones de Equinos (/api/v1), con sus alcances.

Cada consulta necesita un token de una API key con el alcance indicado ([cómo obtenerlo](https://docs.equinos.co/integraciones/api.md#conectarse)). Las listas se paginan con `page` y `per_page` (hasta 100) y muchas aceptan `updated_since` para sincronizar solo lo que cambió.

| Consulta | Alcance |
| - | - |
| `GET /api/v1/me` | cualquiera |
| `GET /api/v1/schools` | `escuelas:read` |
| `GET /api/v1/schools/{school}/students` y `/students/{student}` | `escuelas:read` |
| `GET /api/v1/schools/{school}/classes` | `escuelas:read` |
| `GET /api/v1/schools/{school}/enrollments` | `escuelas:read` |
| `POST /api/v1/schools/{school}/leads` | `escuelas:write` |
| `GET /api/v1/schools/{school}/receivables` | `finanzas:read` |
| `POST /api/v1/schools/{school}/receivables/{receivable}/payments` | `finanzas:write` |
| `GET /api/v1/studs` | `criaderos:read` |
| `GET /api/v1/studs/{stud}/horses` | `criaderos:read` |
| `GET /api/v1/studs/{stud}/clients` | `criaderos:read` |
| `POST /api/v1/studs/{stud}/leads` | `criaderos:write` |
| `GET /api/v1/organizers/{organizer}/events` | `ferias:read` |
| `GET /api/v1/organizers/{organizer}/events/{event}/entries` | `ferias:read` |

Un alcance de escritura (`:write`) incluye la consulta del mismo módulo.

## Errores

| Código | Qué significa |
| - | - |
| `401` | Token vencido, inválido o de una key revocada: pide otro token |
| `403` | La key no tiene el alcance (`insufficient_scope`) o el plan ya no incluye el API (`feature_not_available`) |
| `404` | El registro no existe o no es de tu organización |
| `422` | Datos inválidos, por ejemplo un pago mayor que el saldo, o una `Idempotency-Key` repetida con otros datos |
| `429` | Superaste las llamadas por minuto: espera los segundos de `Retry-After` |


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