Company

Service to validate by NIT registered in Colombia or US document number, and return company information and commercial registration.

POST /validate/company/representatives HTTP/1.1
HOST: {{api_auco}}
Authorization: {{private_key}}

info

This service uses the company's private key.

Nombre	Descripción
email String	Required. Email of the process creator. This email must be registered on the Auco platform and must belong to the company.
documentNumber String	Required. NIT (without verification digit) of the company to be consulted in the case of Colombia, or document number in the case of the United States.
country String	Required. Country where the company to be consulted is registered. Accepted values: CO
targetWebhooks Array<String>	Optional. List of webhooks to be notified. If not defined, it will be sent to the "default" webhook.
tags Array<String>	Optional. List of tags to be sent when notifying the configured webhooks.

🧪 Usage examples

Curl

curl -X POST '{{api_auco}}/validate/company/representatives' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "email": "prueba@auco.ai",
    "documentNumber": "901431536",
    "country": "CO"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/validate/company/representatives',
  headers={'Authorization': '{{private_key}}'},
  json={
    "email": "prueba@auco.ai",
    "documentNumber": "901431536",
    "country": "CO"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/validate/company/representatives', {
  email: 'prueba@auco.ai',
  documentNumber: '901431536',
  country: 'CO'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

📥 Example responses

200: Successful query in Colombia.

{
  "code": "XXXXXXXX",
  "codigo_camara": "21",
  "camara_comercio": "MEDELLIN PARA ANTIOQUIA",
  "matricula": "68393312",
  "inscripcion_proponente": "000000000000",
  "razon_social": "MICONTRATO S.A.S.",
  "codigo_clase_identificacion": "02",
  "clase_identificacion": "NIT",
  "numero_identificacion": "901431536",
  "nit": "901431536",
  "digito_verificacion": "3",
  "cod_ciiu_act_econ_pri": "6201",
  "cod_ciiu_act_econ_sec": "6202",
  "ciiu3": "5820",
  "fecha_matricula": "20201118",
  "fecha_renovacion": "20250328",
  "ultimo_ano_renovado": "2025",
  "fecha_vigencia": "99991231",
  "codigo_tipo_sociedad": "02",
  "tipo_sociedad": "SOCIEDAD COMERCIAL",
  "codigo_organizacion_juridica": "16",
  "organizacion_juridica": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
  "codigo_categoria_matricula": "01",
  "categoria_matricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
  "codigo_estado_matricula": "01",
  "estado_matricula": "ACTIVA",
  "clase_identificacion_rl": "CEDULA DE CIUDADANIA",
  "num_identificacion_representante_legal": "1037644437",
  "representante_legal": "SANTIAGO  MONTOYA GIRALDO",
  "fecha_actualizacion": "2025/03/28 17:30:59.340000000",
  "detailRM": {
    "id": "210068393312",
    "cod_camara": "21",
    "camara": "MEDELLIN PARA ANTIOQUIA",
    "matricula": "0068393312",
    "razon_social": "MICONTRATO S.A.S.",
    "sigla": null,
    "clase_identificacion": "NIT",
    "numero_identificacion": "901431536",
    "numero_identificacion_2": "00000901431536",
    "dv": "3",
    "dir_comercial": null,
    ...
    "cod_ciiu_act_econ_pri": "6201",
    "desc_ciiu_act_econ_pri": "Actividades de desarrollo de sistemas informáticos (planificación, análisis, diseño, programación, pruebas)",
    "cod_ciiu_act_econ_sec": "6202",
    "desc_ciiu_act_econ_sec": "Actividades de consultoría informática y actividades de administración de instalaciones informáticas",
    "ciiu3": "5820",
    "desc_ciiu3": "Edición de programas de informática (software)",
    "ciiu4": "",
    "desc_ciiu4": "",
    "fecha_matricula": "20201118",
    "fecha_renovacion": "20250328",
    "ultimo_ano_renovado": "2025",
    "fecha_vigencia": "99991231",
    "fecha_cancelacion": "",
    "motivo_cancelacion": "",
    "cod_tipo_sociedad": "02",
    "tipo_sociedad": "SOCIEDAD COMERCIAL",
    "organizacion_juridica": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
    "categoria_matricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
    "indicador_emprendimiento_social": "N",
    "extincion_dominio": "N",
    "estado": "ACTIVA",
    "fecha_actualizacion": "20251014",
    "control_inactivacion_sipref": null,
    ...
    "url_venta_certificados": "http://virtuales.camaramedellin.com.co/e-cer/"
  }
}

⚠️ Error Responses

Code	Description
400	Missing parameters like photo or documentImage. Incorrect image format.
401	Invalid or missing authentication.