RUES - Croma API

RUES é o registro comercial unificado da Colômbia. A Croma expõe dois endpoints sobre ele: buscar entidades por nome (cada resultado enriquecido com seu registro completo) e resolver uma entidade por NIT (com demonstrações financeiras, renovações, vínculos e notícias mercantis).

Buscar por nome

POST /co/rues/entities-by-name/v1 busca no RUES por nome de entidade e retorna uma página de resultados, cada um com seu registro completo.

Campo	Tipo	Notas
`name`	string	Obrigatório. Nome da entidade a buscar.
`page`	integer	1-1000. Por padrão `1`. 10 resultados por página.

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

Resolver por NIT

POST /co/rues/entity-by-nit/v1 resolve uma entidade pelo seu NIT. Quando nenhuma entidade coincide exatamente, found é false e os campos do registro ficam vazios.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. O NIT da entidade (4-15 dígitos).

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 é uma fonte ao vivo e pode responder com lentidão ou ficar brevemente indisponível. Estes endpoints podem retornar 502 upstream_error; tente novamente com backoff.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.