> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Inicio rápido
> APIs de datos gubernamentales para Colombia, Perú y búsqueda web global, normalizadas en JSON estructurado.
La API de Croma convierte fuentes de datos del sector público en JSON limpio y
estructurado para equipos de producto y agentes de IA. Una sola llave bearer,
una misma forma consistente de solicitud y respuesta, en todas las fuentes.
## Qué puedes consultar
Busca procesos judiciales colombianos, resuelve un caso por radicación y
lista sus actuaciones.
Verifica si una cédula colombiana está vigente o cancelada por muerte.
Consulta radicaciones de casos jurisdiccionales e historial de actuaciones
de la Superintendencia Financiera de Colombia.
Consulta casos de insolvencia de persona natural en Colombia por documento.
Verifica los antecedentes penales de una persona en Colombia por documento.
Verifica los antecedentes de la Procuraduría de una persona o entidad
(registros disciplinarios, penales, fiscales y contractuales vía SIRI) por
documento.
Verifica si una persona está reportada como responsable fiscal en el boletín
SIBOR de la Contraloría.
Verifica si una persona o entidad es deudora morosa del Estado colombiano
(Boletín de Deudores Morosos del Estado, BDME, de la Contaduría).
Resuelve una entidad colombiana (RUES) por NIT o nombre: registro mercantil,
información financiera, representantes legales y avisos.
Resuelve un proceso de contratación de SECOP II y sus contratos adjudicados,
o busca por proveedor o entidad contratante.
Resuelve un vehículo colombiano (RUNT) por placa y el documento del
propietario registrado: registro, SOAT, revisiones y más.
Lecturas en vivo de clima, lluvia y calidad del aire de las estaciones del
Valle de Aburrá (Medellín), filtrables por ubicación.
Consulta la información de contribuyentes RUC del Perú a partir de un número
de DNI o RUC.
Verifica los datos del carné de identidad de extranjeros en Perú.
Búsqueda web potenciada por IA con resultados estructurados y puntuados.
## Obtén una llave de API
Las llaves de Croma se emiten por **organización** en
[platform.usecroma.com](https://platform.usecroma.com). Una llave se ve como
`croma_live_…` (o `croma_test_…` fuera de producción). Trátala como un secreto.
Otorga acceso completo a la API de tu organización.
Las llaves personales son rechazadas. La API solo acepta llaves con alcance de
organización. Consulta [Autenticación](/es/authentication) para más detalles.
## Haz una solicitud
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`.
```bash cURL theme={"dark"}
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 }'
```
```ts TypeScript theme={"dark"}
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();
```
```python Python theme={"dark"}
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()
```
## Lee la respuesta
Las respuestas exitosas envuelven la carga útil bajo `data`:
```json theme={"dark"}
{
"data": { }
}
```
El estado del límite de tasa y un id de solicitud vienen como encabezados de
respuesta; no hay un objeto `meta` en el cuerpo:
```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 2026-05-23T18:00:00.000Z
X-Request-Id: req_8f3c…
```
Todos los endpoints de datos requieren una llave de API bearer.
Referencia completa de endpoints con un playground interactivo.