Quickstart

The Croma API turns public-sector data sources into clean, structured JSON for product teams and AI agents. One bearer key, one consistent request/response shape, across every source.

What you can query

Rama Judicial

Search Colombian judicial processes, resolve a case by radicación, and list its actuaciones.

Registraduría

Check whether a Colombian cédula is active or cancelled due to death.

Superfinanciera

Query jurisdictional case filings and action history from Colombia’s Superintendencia Financiera.

SICAAC

Look up Colombian natural-person insolvency cases by document.

Policía Nacional

Check a person’s Colombian criminal record (antecedentes) by document.

Procuraduría

Check a person or entity’s Procuraduría antecedentes (disciplinary, penal, fiscal, and contractual records via SIRI) by document.

Contraloría

Check whether a person is reported as a responsable fiscal in the Contraloría’s SIBOR boletín.

Contaduría

Check whether a person or entity is a delinquent debtor to the Colombian State (Contaduría’s BDME boletín de deudores morosos del Estado).

RUES

Resolve a Colombian entity (RUES) by NIT or name: registry record, financials, legal representatives, and notices.

SECOP

Resolve a SECOP II procurement process and its awarded contracts, or search by provider or contracting entity.

RUNT

Resolve a Colombian vehicle (RUNT) by plate and the registered owner’s document: registry record, SOAT, inspections, and more.

SIATA

Live weather, rainfall, and air-quality station readings for the Aburrá Valley (Medellín), filterable by location.

SUNAT

Look up Peruvian RUC taxpayer information from a DNI or RUC number.

RREE

Verify Peruvian foreigner identity card data.

Web Search

AI-powered web search with structured, scored results.

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.

Make a request

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…

All data endpoints require a bearer API key.

API Reference

Full endpoint reference with an interactive playground.

Get Started

Colombia

Peru

Global

What you can query

Rama Judicial

Registraduría

Superfinanciera

SICAAC

Policía Nacional

Procuraduría

Contraloría

Contaduría

RUES

SECOP

RUNT

SIATA

SUNAT

RREE

Web Search

Get an API key

Make a request

Read the response

API Reference

​What you can query

Rama Judicial

Registraduría

Superfinanciera

SICAAC

Policía Nacional

Procuraduría

Contraloría

Contaduría

RUES

SECOP

RUNT

SIATA

SUNAT

RREE

Web Search

​Get an API key

​Make a request

​Read the response

API Reference

What you can query

Get an API key

Make a request

Read the response