Quickstart

Get an API key

Croma keys are issued per organization at platform.usecroma.com. A key looks like croma_live_… (or croma_test_… outside production). Treat it as a secret. It carries your org’s full API access.

Personal keys are rejected. The API only accepts organization-scoped keys. See Authentication for details.

Call an endpoint

Every data endpoint is a versioned POST path (for example /co/rama-judicial/cases-by-entity/v1) on https://api.croma.run. It takes a small JSON body and the key in an Authorization: Bearer header.

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

Read the response

Successful responses wrap the payload under data:

{
  "data": { }
}

Rate-limit state and a request id come back as response headers; there’s no meta object in the body:

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

Longer lookups resolve as async jobs: the same request can wait inline, poll, or call you back when done. Failures share one error shape across every endpoint.

Get Started

Countries

Next steps

MCP server

API Reference

​Next steps

MCP server

API Reference

Next steps