Colombia — Deudores morosos (BDME)

Verifik consulta la BDME (Base de Datos de Morosos), el boletín de deudores morosos de la Contaduría General de la Nación, usando documentType y documentNumber. La integración devuelve estado y campos de reporte cuando la fuente responde con coincidencia.

Qué devuelve la API

• Eco de documentType / documentNumber
• status y campos de entidad / ciudad / teléfono cuando existan
• Respuesta firmada por Verifik

Referencia de API

Endpoint

GET https://api.verifik.co/v2/co/deudoresmorosos

Solo GET por query: documentType y documentNumber. No hay ruta POST en el backend actual.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Tipo de documento. Usa CC, CE, PA, NIT o PPT (mapeo a tipos BDME en la integración).
documentNumber	string	sí	Número sin espacios ni signos.

Solicitud

JavaScript

import axios from "axios";

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

Python

import os, requests

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

Respuesta

200

{
	"data": {
		"documentType": "NIT",
		"documentNumber": "800096561",
		"reportingEntity": "…",
		"reportedName": "…",
		"phone": "…",
		"city": "…",
		"status": "…"
	},
	"signature": {
		"dateTime": "January 16, 2024 3:44 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

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

Características

• Personas naturales y NIT vía documentType
• Solo GET con parámetros de consulta
• Flujo con captcha en origen; fallos pueden aparecer como 5xx

Casos de uso

• Crédito y riesgo
• Proveedores y KYB

Notas

• documentType y documentNumber son obligatorios (409 si falta alguno).
• La BDME es un boletín oficial; interpreta resultados según normativa y política interna.
• PPT usa el mapeo de la integración; valida en tu entorno si es crítico.