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

# RUES

> Search Colombian companies by name or resolve one by NIT in RUES, the unified commercial registry, each result enriched with its full registry record.

RUES is Colombia's unified commercial registry. Croma exposes two endpoints over it: **search** entities by name (each result enriched with its full registry record), and **resolve** an entity by NIT (with financials, renewals, related parties and registry notices).

## Search by name

`POST /co/rues/entities-by-name/v1` searches RUES by entity name and returns a page of results, each with its full registry record.

| Field  | Type    | Notes                                     |
| ------ | ------- | ----------------------------------------- |
| `name` | string  | **Required.** Entity name to search.      |
| `page` | integer | 1-1000. Default `1`. 10 results per page. |

```bash theme={"dark"}
curl https://api.croma.run/co/rues/entities-by-name/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "exito" }'
```

## Resolve by NIT

`POST /co/rues/entity-by-nit/v1` resolves an entity by its NIT. When no exact-NIT entity matches, `found` is `false` and the record fields are empty.

| Field             | Type   | Notes                                         |
| ----------------- | ------ | --------------------------------------------- |
| `document_number` | string | **Required.** The entity's NIT (4-15 digits). |

```bash theme={"dark"}
curl https://api.croma.run/co/rues/entity-by-nit/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900654922" }'
```

<Note>
  RUES is a live upstream and can be slow or briefly unavailable. These
  endpoints may return `502 upstream_error`; retry with backoff.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>