Company background check

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,USA
state String	Required if country is defined as USA. Lista de tags que se envian cuando notifique al los webhooks configurados. Accepted values: FL
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.

Responses

200: Successful query in Colombia.

{
  "code": "XXXXXXXX",
  "identificacion": "NIT 901431536 - 3",
  "razon_social": "MICONTRATO S.A.S.",
  "sigla": "",
  "categoria_matricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
  "municipio": "MEDELLIN / ANTIOQUIA",
  "estadoRM": "ACTIVA",
  "detalleRM": ""
}

200: Successful query in the USA.

{
  "code": "XXXXXXXXXX",
  "type": "Florida Limited Liability Company",
  "name": "TEST COMPANY GROUP CORP",
  "document_number": "P22000NNNNNN",
  "fei_ein_number": "88-4342906",
  "date_filed": "10/10/2023",
  "effective_date": "10/10/2023",
  "state": "FL",
  "status": "ACTIVE",
  "principal_address": {
    "address": "1234 SE 1TH COURT",
    "city": "MIAMI",
    "state": "FL",
    "zipcode": "33165"
  },
  "mailing_address": {
    ...
  },
  "registered_agent": {
    "name": "DOE, JHON",
    "address": {
      ...
    }
  },
  "authorized_persons": [
    ...
  ],
  "annual_reports": [
    {
      "year": "2024",
      "filed_date": "03/03/2024"
    }
  ],
  "document_images": [
    {
      "date": "03/03/2024",
      "type": "ANNUAL REPORT",
      "url": "{{DOCUMENT_URL}}"
    },
    {
      ...
    }
  ]
}

Example

HTTP

GET /validate/company/representatives HTTP/1.1
Host: {{api_auco}}
Authorization: {{private_key}}

Node

var axios = require('axios');

axios.get('{{api_auco}}/validate/company/representatives', {
  headers: {
    Authorization: '{{private_key}}'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});