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

# Referencia de API

> Cada endpoint de Croma Legal, con un playground interactivo.

Cada endpoint de esta referencia vive bajo `https://api.legal.usecroma.com` y
se autentica con una clave de API de tipo bearer. Elige un endpoint en la barra
lateral para ver sus parámetros, el esquema de respuesta, un ejemplo y un
playground de "pruébalo".

## Endpoints

| Método | Ruta                                                                                          | Qué devuelve                                                   |
| ------ | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `GET`  | [`/v1/processes`](/es/legal/api-reference/list-processes)                                     | Tus procesos, filtrados y paginados por cursor.                |
| `GET`  | [`/v1/processes/{process_id}`](/es/legal/api-reference/get-process)                           | Un proceso completo. UUID o radicado.                          |
| `GET`  | [`/v1/processes/{process_id}/actions`](/es/legal/api-reference/list-process-actions)          | Las actuaciones de un proceso, más recientes primero.          |
| `GET`  | [`/v1/actions`](/es/legal/api-reference/list-actions)                                         | El feed de actuaciones de toda la organización.                |
| `GET`  | [`/v1/defendants`](/es/legal/api-reference/list-defendants)                                   | Tus demandados con número de procesos.                         |
| `GET`  | [`/v1/defendants/{defendant_id}/processes`](/es/legal/api-reference/list-defendant-processes) | Todos los procesos vinculados a un demandado.                  |
| `GET`  | [`/v1/analytics`](/es/legal/api-reference/get-analytics)                                      | KPIs y distribuciones sobre el portafolio.                     |
| `POST` | [`/v1/exports`](/es/legal/api-reference/create-export)                                        | Una exportación CSV / JSONL del conjunto completo (asíncrona). |
| `GET`  | [`/jobs/{id}`](/es/legal/api-reference/get-job)                                               | Estado y resultado de un trabajo de exportación.               |

## Convenciones

* **Auth**: `Authorization: Bearer <clave>` en cada endpoint. Consulta [Autenticación](/es/legal/authentication).
* **Los endpoints de lectura son `GET`** con los filtros como parámetros de consulta; solo las exportaciones son un `POST` con cuerpo JSON.
* **Éxito**: las respuestas envuelven la carga bajo `data`: `{ "data": … }`. Las listas agregan `next_cursor` y `has_more` (o `total`).
* **Errores**: `{ "error": { "type", "code", "message" } }` con un estado distinto de 2xx. Consulta [Errores](/es/legal/errors).
* **Sin coincidencia**: una lista vacía es un `200`, no un `404`. Solo los endpoints de un proceso individual devuelven `404`, cuando el id o radicado no está en tu organización.
* **Nombres de campo** en `snake_case`; fechas en ISO 8601 en UTC; ids en UUID, y los procesos aceptan también su radicado.
* **Límites de tasa**: se reportan en los encabezados de respuesta `X-RateLimit-*`. Consulta [Límites de tasa](/es/legal/rate-limits).
* **Alcance**: cada respuesta está limitada a la organización dueña de la clave. No hay un parámetro para elegir otra organización.

<Note>
  Los nombres de parámetros y las descripciones de campos de cada endpoint se
  muestran en inglés, el idioma del contrato de la API.
</Note>

<CardGroup cols={2}>
  <Card title="Paginación y filtros" icon="list" href="/es/legal/pagination">
    Cursores, tamaños de página, semántica de fechas y sincronización incremental.
  </Card>

  <Card title="Exportaciones" icon="file-arrow-down" href="/es/legal/exports">
    Espera en línea, haz polling u obtén un callback para el conjunto completo.
  </Card>
</CardGroup>