Inicio rápido

Obtén una llave de API

Las llaves de Croma se emiten por organización en platform.usecroma.com. Una llave se ve como croma_live_… (o croma_test_… fuera de producción). Trátala como un secreto. Otorga el acceso completo de tu organización a la API.

Las llaves personales se rechazan. La API solo acepta llaves con alcance de organización. Consulta Autenticación para más detalles.

Llama un endpoint

Cada endpoint de datos es una ruta POST versionada (por ejemplo /co/rama-judicial/cases-by-entity/v1) en https://api.croma.run. Recibe un cuerpo JSON pequeño y la llave en un encabezado Authorization: Bearer.

curl https://api.croma.run/co/rama-judicial/cases-by-entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "PEDRO CIFUENTES", "entity_type": "natural", "page": 1 }'

const res = await fetch("https://api.croma.run/co/rama-judicial/cases-by-entity/v1", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CROMA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "PEDRO CIFUENTES", entity_type: "natural", page: 1 }),
});

const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.croma.run/co/rama-judicial/cases-by-entity/v1",
    headers={"Authorization": f"Bearer {os.environ['CROMA_API_KEY']}"},
    json={"name": "PEDRO CIFUENTES", "entity_type": "natural", "page": 1},
)
body = res.json()

Lee la respuesta

Las respuestas exitosas envuelven el contenido bajo data:

{
  "data": { }
}

El estado del límite de tasa y un id de solicitud llegan como encabezados de respuesta; no hay objeto meta en el cuerpo:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 2026-05-23T18:00:00.000Z
X-Request-Id: req_8f3c…

Las consultas largas se resuelven como trabajos asíncronos: la misma solicitud puede esperar en línea, consultarse por polling o notificarte por callback al terminar. Las fallas comparten una misma forma de error en todos los endpoints.

Próximos pasos

Servidor MCP

Conecta cualquier cliente MCP a todas las herramientas de Croma con una sola URL.

Referencia de API

Referencia completa de endpoints con un playground interactivo.

Primeros pasos

Países

Próximos pasos

Servidor MCP

Referencia de API

​Próximos pasos

Servidor MCP

Referencia de API

Próximos pasos