Consulta de compañia

Servicio para validar por NIT registrado en Colombia o número de documento de Estados Unidos y devuelve información de la compañía y registro mercantil.

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

info

Este servicio usa la llave privada de la compañia

Nombre	Descripción
email String	Obligatorio. Correo electrónico del creador del proceso. Este correo debe estar registrado en la plataforma de Auco y debe pertenecer a la compañía.
documentNumber String	Obligatorio. NIT sin digito de verificacion de la empresa a consultar para el caso de Colombia o numero de documento para el caso de Estados Unidos.
country String	Obligatorio. País donde se encuentra registrada la empresa a consultar. Valores aceptados: `CO`,`USA`
state String	Obligatorio si `country` es definido como `USA`. Estado donde se encuentra registrada la empresa. Valores aceptados: `FL`
targetWebhooks Array<String>	Opcional. Lista de webhooks a ser notificados. En caso de no definir se envia al webhook "default".
tags Array<String>	Opcional. Lista de tags que se envian cuando notifique al los webhooks configurados.

Respuestas

200: Consulta exitosa en Colombia.
200: Consulta exitosa en USA.

{
  "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": ""
}

{
  "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}}"
    },
    {
      ...
    }
  ]
}

Ejemplo

HTTP
Node

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

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);
});

Respuestas​

Ejemplo​

Respuestas

Ejemplo