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.

Chaves pessoais são rejeitadas. A API só aceita chaves com escopo de organização. 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": "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()

Leia a resposta

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

{
  "data": { }
}

O status do limite de taxa e um id de solicitação chegam como cabeçalhos de resposta; não há objeto meta no corpo:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 2026-05-23T18: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

Países

Próximos passos

Servidor MCP

Referência da API

​Próximos passos

Servidor MCP

Referência da API

Próximos passos