Colombia - Verificación DIAN

Endpoint

https://api.verifik.co/v2/co/company/dian

Valida el estado DIAN (autoridad tributaria de Colombia) de una empresa.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description
documentType	string	Yes	Tipo de documento. Parámetro permitido: NIT.
documentNumber	string	Yes	NIT (con o sin dígito de verificación).

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/company/dian", {
  params: { documentType: "NIT", documentNumber: "901708460" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/company/dian"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "NIT", "documentNumber": "901708460"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

La API puede devolver dos tipos de respuestas exitosas (200):

1. Respuesta de Empresa: Información estándar de empresa
2. Respuesta de Persona Natural: Cuando el NIT pertenece a una "persona natural" registrada en DIAN, la respuesta incluye campos adicionales de nombre que son divididos por las funciones internas de Verifik.

200 - Empresa

{
  "data": {
    "date": "2025-10-10T16:49:00Z",
    "descripcion": "Los datos de la persona estan activos, es decir tiene vigentes sus responsabilidades ",
    "estado": "REGISTRO ACTIVO",
    "nombreRazon": "SAY SHANNON COLOMBIA SAS",
    "nit": "901708460"
  },
  "signature": {
    "dateTime": "October 10, 2025 4:49 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "5RCBO"
}

200 - Persona Natural

{
  "data": {
    "date": "2026-01-20T22:07:00Z",
    "descripcion": "Los datos de la persona estan activos, es decir tiene vigentes sus responsabilidades ",
    "estado": "REGISTRO ACTIVO",
    "nombreRazon": "RODRIGUEZ MARTINEZ CARLOS ANDRES",
    "nit": "1234567890",
    "fullName": "CARLOS ANDRES RODRIGUEZ MARTINEZ",
    "firstName": "CARLOS ANDRES",
    "lastName": "RODRIGUEZ MARTINEZ",
    "arrayName": [
      "RODRIGUEZ",
      "MARTINEZ",
      "CARLOS",
      "ANDRES"
    ]
  },
  "signature": {
    "dateTime": "January 20, 2026 10:07 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "5SQEM"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [NIT]"
}

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n"
}

{
  "code": "MissingParameter",
  "message": "missing documentType\n"
}

500

{
  "code": "InternalServerError",
  "message": "Server error."
}

Notas

• Usa entrada de NIT limpia; el servicio considera el dígito de verificación.
• División de Nombres para Personas Naturales: Cuando la respuesta es para una "persona natural", Verifik divide automáticamente el nombre del campo nombreRazon en firstName, lastName, fullName y arrayName usando funciones internas. Sin embargo, dado que los datos de origen devuelven el nombre como un solo campo (nombreRazon), la división puede no ser siempre 100% precisa. El campo nombreRazon siempre contiene el nombre original sin modificar tal como lo devuelve DIAN.