Colombia — Delinquent debtors (BDME)

Verifik queries BDME (Base de Datos de Morosos), the Colombian delinquent debtors bulletin published by Contaduría General de la Nación (via the official BDME web portal), using documentType and documentNumber. The integration returns a status line and reporting fields when the source responds with a match.

Use this for credit risk, onboarding, and compliance checks where BDME consultation is allowed.

What this API returns

• documentType / documentNumber echoed from the request
• status — bulletin state text from the upstream response
• reportingEntity, reportedName, city, phone — fields parsed from the BDME payload when present
• A signed Verifik wrapper (data + signature)

API reference

Endpoint

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

Query-only GET; pass documentType and documentNumber. There is no POST route for this path in the current backend.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentType	string	yes	Document category. Use CC, CE, PA, NIT, or PPT (maps to BDME identification types in the integration).
documentNumber	string	yes	ID number without spaces or punctuation.

Request

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())

Response

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

Features

• Natural persons and companies (e.g. NIT) supported via documentType
• GET query parameters only
• Captcha-backed upstream flow (failures may surface as 5xx or service errors)

Use cases

• Lending and credit decisioning
• Vendor and KYB risk checks

Notes

• Both documentType and documentNumber are required; the API returns 409 if either is missing.
• BDME is an official debtor bulletin; interpret status and entity fields under your legal and policy rules.
• Upstream captcha or portal outages may cause failures (e.g. captcha resolution errors).
• PPT uses the integration’s PPT mapping; confirm behaviour in your environment if you rely on it.