Inicio rápido

Obtén una clave de API

Las claves se crean en el dashboard de Croma Legal en 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.

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.

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.

curl "https://api.legal.usecroma.com/v1/processes?status=TRACKING&page_size=5" \
  -H "Authorization: Bearer $CROMA_LEGAL_API_KEY"

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();

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()

Lee la respuesta

Los endpoints de lista devuelven las filas bajo data más un cursor para la siguiente página:

{
  "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). 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…

Sigue adelante

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

# 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

Paginación y filtros

Cursores, tamaños de página, semántica de fechas y cómo sincronizar de forma incremental.

Referencia de API

Cada endpoint con sus parámetros, campos de respuesta y un playground.

Exportaciones

Descarga el conjunto de datos completo como CSV o JSONL en vez de paginar.

Servidor MCP

Apunta Claude, ChatGPT o tu propio agente a los mismos datos.

Primeros pasos

Guías

Referencia de API

Sigue adelante

Siguientes pasos

Paginación y filtros

Referencia de API

Exportaciones

Servidor MCP

​Sigue adelante

​Siguientes pasos

Paginación y filtros

Referencia de API

Exportaciones

Servidor MCP

Sigue adelante

Siguientes pasos