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

# Inicio rápido

> Obtén una clave de la API de Croma Legal y lista tus procesos en tres pasos.

<Steps>
  <Step title="Obtén una clave de API">
    Las claves se crean en el dashboard de Croma Legal en
    [legal.usecroma.com](https://legal.usecroma.com): abre **Desarrolladores**
    y luego **Claves de API**. Las claves pertenecen a tu **organización**,
    tienen la forma `croma_live_…` y se muestran una sola vez al crearlas, así
    que cópiala antes de salir de la página.

    <Note>
      La gestión de claves la habilita Croma por usuario. Si no ves la pestaña
      **Claves de API**, pide a tu contacto en Croma que la active para tu
      cuenta. Consulta [Autenticación](/es/legal/authentication).
    </Note>
  </Step>

  <Step title="Lista tus procesos">
    Todos los endpoints viven bajo `https://api.legal.usecroma.com/v1` y
    reciben la clave en un encabezado `Authorization: Bearer`. Los filtros van
    como parámetros de consulta.

    <CodeGroup>
      ```bash cURL theme={"dark"}
      curl "https://api.legal.usecroma.com/v1/processes?status=TRACKING&page_size=5" \
        -H "Authorization: Bearer $CROMA_LEGAL_API_KEY"
      ```

      ```ts TypeScript theme={"dark"}
      const url = new URL("https://api.legal.usecroma.com/v1/processes");
      url.searchParams.set("status", "TRACKING");
      url.searchParams.set("page_size", "5");

      const res = await fetch(url, {
        headers: { Authorization: `Bearer ${process.env.CROMA_LEGAL_API_KEY}` },
      });

      const { data, next_cursor, has_more } = await res.json();
      ```

      ```python Python theme={"dark"}
      import os, requests

      res = requests.get(
          "https://api.legal.usecroma.com/v1/processes",
          headers={"Authorization": f"Bearer {os.environ['CROMA_LEGAL_API_KEY']}"},
          params={"status": "TRACKING", "page_size": 5},
      )
      body = res.json()
      ```
    </CodeGroup>
  </Step>

  <Step title="Lee la respuesta">
    Los endpoints de lista devuelven las filas bajo `data` más un cursor para
    la siguiente página:

    ```json theme={"dark"}
    {
      "data": [
        {
          "id": "3f1c2a44-9b1e-4c5a-8d2f-6a7b8c9d0e1f",
          "registration_number": "11001400300120240012300",
          "plaintiff_name": "BANCO EJEMPLO S.A.",
          "defendant_name": "CLIENTE DE EJEMPLO",
          "office": "JUZGADO 001 CIVIL MUNICIPAL DE BOGOTÁ",
          "status": "TRACKING",
          "registration_date": "2024-03-12T00:00:00.000Z",
          "last_discovery_date": "2026-08-20T09:14:33.000Z",
          "defendant_id": "1234567890"
        }
      ],
      "next_cursor": "5",
      "has_more": true
    }
    ```

    Envía `next_cursor` de vuelta como `cursor` para obtener la siguiente
    página (consulta [Paginación y filtros](/es/legal/pagination)). El estado
    del límite de tasa y un id de solicitud vienen como encabezados de
    respuesta:

    ```
    X-RateLimit-Limit: 1000
    X-RateLimit-Remaining: 999
    X-RateLimit-Reset: 2026-08-22T09:14:33.000Z
    X-Request-Id: req_8f3c…
    ```
  </Step>
</Steps>

## Sigue adelante

Algunas llamadas que vas a necesitar después. Donde se identifica un proceso,
se acepta el radicado o el `id` interno.

```bash theme={"dark"}
# Un proceso completo, por radicado
curl "https://api.legal.usecroma.com/v1/processes/11001400300120240012300" \
  -H "Authorization: Bearer $CROMA_LEGAL_API_KEY"

# Todo lo registrado desde tu última sincronización, en todos los procesos
curl "https://api.legal.usecroma.com/v1/actions?since=2026-08-20T00:00:00Z&since_mode=discovered" \
  -H "Authorization: Bearer $CROMA_LEGAL_API_KEY"

# KPIs del portafolio, agrupados por mes
curl "https://api.legal.usecroma.com/v1/analytics?granularity=month&days=365" \
  -H "Authorization: Bearer $CROMA_LEGAL_API_KEY"

# El portafolio completo como descarga CSV
curl -X POST "https://api.legal.usecroma.com/v1/exports" \
  -H "Authorization: Bearer $CROMA_LEGAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "entity": "processes", "format": "csv" }'
```

## Siguientes pasos

<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 cómo sincronizar de forma incremental.
  </Card>

  <Card title="Referencia de API" icon="code" href="/es/legal/api-reference/overview">
    Cada endpoint con sus parámetros, campos de respuesta y un playground.
  </Card>

  <Card title="Exportaciones" icon="file-arrow-down" href="/es/legal/exports">
    Descarga el conjunto de datos completo como CSV o JSONL en vez de paginar.
  </Card>

  <Card title="Servidor MCP" icon="plug" href="/es/legal/mcp-server">
    Apunta Claude, ChatGPT o tu propio agente a los mismos datos.
  </Card>
</CardGroup>