RUES - Croma API

RUES es el Registro Único Empresarial y Social de Colombia. Croma expone dos endpoints sobre él: buscar entidades por nombre (cada resultado enriquecido con su registro completo) y resolver una entidad por NIT (con estados financieros, renovaciones, vínculos y noticias mercantiles).

Buscar por nombre

POST /co/rues/entities-by-name/v1 busca en RUES por nombre de entidad y devuelve una página de resultados, cada uno con su registro completo.

Campo	Tipo	Notas
`name`	string	Obligatorio. Nombre de la entidad a buscar.
`page`	integer	1-1000. Por defecto `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 resuelve una entidad por su NIT. Cuando ninguna entidad coincide exactamente, found es false y los campos del registro quedan vacíos.

Campo	Tipo	Notas
`document_number`	string	Obligatorio. El NIT de la entidad (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 es una fuente en vivo y puede responder con lentitud o estar brevemente no disponible. Estos endpoints pueden devolver 502 upstream_error; reintenta con backoff.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.