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. 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": "RAPPI", "entity_type": "juridical", "active_only": true }'

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: "RAPPI", entity_type: "juridical", active_only: true }),
});

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": "RAPPI", "entity_type": "juridical", "active_only": True},
)
body = res.json()

Lee la respuesta

Las respuestas exitosas envuelven el contenido bajo data:

{
  "data": { }
}

El saldo de créditos de tu plan y un id de solicitud llegan como encabezados de respuesta; no hay objeto meta en el cuerpo. El límite son los créditos que tu plan otorga cada mes, lo restante es lo que queda después de esta llamada (una consulta en vivo gasta 10) y el reinicio es cuando el saldo se renueva:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4990
X-RateLimit-Reset: 2026-10-01T00: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

Tipos de solicitud

Monitores

Países

Próximos pasos

Servidor MCP

Referencia de API

​Próximos pasos

Servidor MCP

Referencia de API

Próximos pasos