Início rápido

Obtenha uma chave de API

As chaves da Croma são emitidas por organização em platform.usecroma.com. Uma chave se parece com croma_live_… (ou croma_test_… fora de produção). Trate-a como um segredo. Ela concede o acesso completo da sua organização à API. Consulte Autenticação para mais detalhes.

Chame um endpoint

Cada endpoint de dados é uma rota POST versionada (por exemplo /co/rama-judicial/cases-by-entity/v1) em https://api.croma.run. Ele recebe um corpo JSON pequeno e a chave em um cabeçalho 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()

Leia a resposta

As respostas bem-sucedidas envolvem o conteúdo em data:

{
  "data": { }
}

O saldo de créditos do seu plano e um id de solicitação chegam como cabeçalhos de resposta; não há objeto meta no corpo. O limite são os créditos que o seu plano concede por mês, o restante é o que sobra depois desta chamada (uma consulta ao vivo gasta 10) e o reinício é quando o saldo se renova:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4990
X-RateLimit-Reset: 2026-10-01T00:00:00.000Z
X-Request-Id: req_8f3c…

As consultas longas são resolvidas como trabalhos assíncronos: a mesma solicitação pode aguardar de forma síncrona, ser consultada por polling ou notificar você por callback ao terminar. As falhas compartilham um mesmo formato de erro em todos os endpoints.

Próximos passos

Servidor MCP

Conecte qualquer cliente MCP a todas as ferramentas da Croma com uma única URL.

Referência da API

Referência completa de endpoints com um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Países

Próximos passos

Servidor MCP

Referência da API

​Próximos passos

Servidor MCP

Referência da API

Próximos passos