RUES - Croma API

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.

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

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" }'

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

Full reference

Schemas, all response fields, and an interactive playground.