> ## 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.

# Quickstart

> Government-data APIs for Colombia, Peru, and global web search, normalized into structured JSON.

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

<CardGroup cols={2}>
  <Card title="Rama Judicial" icon="scale-balanced" href="/guides/colombia/rama-judicial">
    Search Colombian judicial processes, resolve a case by radicación, and list
    its actuaciones.
  </Card>

  <Card title="Registraduría" icon="id-card" href="/guides/colombia/registraduria">
    Check whether a Colombian cédula is active or cancelled due to death.
  </Card>

  <Card title="Superfinanciera" icon="building-columns" href="/guides/colombia/superfinanciera">
    Query jurisdictional case filings and action history from Colombia's
    Superintendencia Financiera.
  </Card>

  <Card title="SICAAC" icon="file-contract" href="/guides/colombia/sicaac">
    Look up Colombian natural-person insolvency cases by document.
  </Card>

  <Card title="Policía Nacional" icon="fingerprint" href="/guides/colombia/policia">
    Check a person's Colombian criminal record (antecedentes) by document.
  </Card>

  <Card title="Procuraduría" icon="user-shield" href="/guides/colombia/procuraduria">
    Check a person or entity's Procuraduría antecedentes (disciplinary, penal,
    fiscal, and contractual records via SIRI) by document.
  </Card>

  <Card title="Contraloría" icon="money-check-dollar" href="/guides/colombia/contraloria">
    Check whether a person is reported as a responsable fiscal in the
    Contraloría's SIBOR boletín.
  </Card>

  <Card title="Contaduría" icon="landmark" href="/guides/colombia/contaduria">
    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).
  </Card>

  <Card title="RUES" icon="building" href="/guides/colombia/rues">
    Resolve a Colombian entity (RUES) by NIT or name: registry record,
    financials, legal representatives, and notices.
  </Card>

  <Card title="SECOP" icon="file-signature" href="/guides/colombia/secop">
    Resolve a SECOP II procurement process and its awarded contracts, or search
    by provider or contracting entity.
  </Card>

  <Card title="RUNT" icon="car" href="/guides/colombia/runt">
    Resolve a Colombian vehicle (RUNT) by plate and the registered owner's
    document: registry record, SOAT, inspections, and more.
  </Card>

  <Card title="SIATA" icon="cloud-sun" href="/guides/colombia/siata">
    Live weather, rainfall, and air-quality station readings for the Aburrá
    Valley (Medellín), filterable by location.
  </Card>

  <Card title="SUNAT" icon="receipt" href="/guides/peru/sunat">
    Look up Peruvian RUC taxpayer information from a DNI or RUC number.
  </Card>

  <Card title="RREE" icon="passport" href="/guides/peru/rree">
    Verify Peruvian foreigner identity card data.
  </Card>

  <Card title="Web Search" icon="magnifying-glass" href="/guides/global/web-search">
    AI-powered web search with structured, scored results.
  </Card>
</CardGroup>

## Get an API key

Croma keys are issued per **organization** at
[platform.usecroma.com](https://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.

<Note>
  Personal keys are rejected. The API only accepts organization-scoped keys.
  See [Authentication](/authentication) for details.
</Note>

## 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.

<CodeGroup>
  ```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()
  ```
</CodeGroup>

## Read the response

Successful responses wrap the payload under `data`:

```json theme={"dark"}
{
  "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.

<Card title="API Reference" icon="code" href="/api-reference/overview">
  Full endpoint reference with an interactive playground.
</Card>