Registro Unico Empresarial de Colombia (RUES)

Lets integrate Registro Unico Empresarial de Colombia (RUES) in your system. First, get your Apitude API key, then send a POST request to Apitude... And that's it!.

Get API Access
That POST request should return the following

    "message": "Request processed successfully",
    "url": "/api/v1.0/requests/rues-co/e0606c19-a32d-410f-b2eb-d57a665677bc/",
    "request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
This response will contains a unique request ID that you should poll using a GET as follows
How does the response looks like?

   "result": {
      "data": {
         "found": true,
         "certificado": {
            "representacion_legal": [
                  "39636541": "RAMOS MYRIAM"
         "info_basica": {
            "sigla": "",
            "identificacion": "SIN IDENTIFICACION 100",
            "camara_de_comercio": "PIEDEMONTE ARAUCANO"
         "actividades_economicas": [
         "registro_de_proponentes": {
            "fecha_de_renovacion": "1998-12-07",
            "fecha_de_cancelacion": "2000-12-13",
            "fecha_de_inscripcion": "2000-01-07",
            "estado_del_proponente": "NO RENOVADO",
            "numero_de_inscripcion_rup": "000000000082",
            "camara_de_comercio_proponente_rup": "LA DORADA"
         "registro_entidades_sin_animo_de_lucro": {
            "afiliado": "N",
            "empleados": "1",
            "tipo_de_sociedad": "ENTIDAD SIN ANIMO DE LUCRO",
            "fecha_de_vigencia": "INDEFINIDA",
            "fecha_de_matricula": "1996-09-20",
            "motivo_cancelacion": "NORMAL",
            "fecha_de_renovacion": "2015-07-27",
            "numero_de_matricula": "9000500027",
            "ultimo_ano_renovado": "2015",
            "fecha_de_cancelacion": "",
            "tipo_de_organizacion": "ENTIDADES DE NATURALEZA COOPERATIVA",
            "beneficiario_ley_1780": "",
            "estado_de_la_matricula": "",
            "categoria_de_la_matricula": "SOCIEDAD O PERSONA JURIDICA PRINCIPAL O ESAL"
      "error": "",
      "end_at": "2020-05-30 21:54:06.453355",
      "status": 200,
      "message": "successful",
      "queried_by": "YOUR-USER",
      "service_name": "rues-co"
   "message": "Request completed"
Ok, but what does each field in that JSON means?
The general parts:

  • message:The message is an Apitude generated string with an informational text about the request.
  • result:The result is contains the main part of the request.
  • result.error:The error is a string generated by apitude for the request if everything worked it will be blank.
  • result.message:The message is a string with two options successful or unsuccessful depending of how your request finished.
  • result.queried_by:The queried_by field is a string that lets you know what user started the request.
  • result.end_at:The end_at field is a string formatted date that lets you know at what time the request ended in Apitude.
  • result.service_name:The service_name field is a string that echos the service called. For this service it will always be rues-co.
  • result.status:The status field is a integer that represents whether the service returned data from the input sent in the request. It could be one of the following values:
    • 200: The service returned response data for the payload that was sent in the creation of the request.
    • 404: The service did not returned data for the payload that was sent in the creation of the request.
    • 400: The service did not started because your input was invalid.
    • 500: Apitude tried to execute your request, however the service Apitude uses to execute your request was down. Please wait some time and try again, Apitude will not charged you for requests with this code.

    Depending on the service, you want it to return different codes. For example, if you are checking the user against a security list to whitelist the user you should look for a 404, because a 200 would mean the user is in fact in the list. Other cases however, like creating objects in the name of a user you want the code to be 200, since it will imply the creation was a success.

The data in the response:

Please refer to the official docs of this service online to find out more about what data is returned.

About this service

It is an administrative institution whose objective is the official publicity of the legal situations of the registered entrepreneurs. The primary function of the commercial register is to be an advertising tool. Entrepreneurs are obliged to communicate a series of information that is considered essential for legal traffic, and the commercial register allows the publication of such information, for greater legal and economic security. Certain information can also be voluntarily included by the business owners, such as legal status.

Who can you query using this service?:

This service (rues-co) is available for you to query companies/businesses only.

Get API Access