The Delinquent Debtors Service allows users to query their debt status with the Colombian government. By providing a NIT or citizen ID number, users can access detailed information on any outstanding debts, including the type, object, year, period, and date of the debt.

Parameters

Name Type ¿Required? Description Example
documentType String True Type of document to consult, allowed values: CC, TI, NIT, CE. CC
documentNumber String True Document number of the person or company to consult, without spaces or dots and in case of being a company, without verification code. 123456789

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/deudoresmorosos>',
  params: {documentType: 'CC', documentNumber: '123456789'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "data": [
    {
      "impuesto": "PREDIAL",
      "objeto": "BBN1234",
      "vigencia": "2019",
      "periodo": "0",
      "fecha": "10-06-2022"
    },
    {
      "impuesto": "vehiculoS",
      "objeto": "ABC123",
      "vigencia": "2020",
      "periodo": "0",
      "fecha": "10-06-2022"
    }
  ],
  "signature": {
    "dateTime": "June 10, 2022 10:02 AM",
    "message": "Certified by Verifik.co"
  }
}

Other responses

Code Description Response Body
404 Not Found Information not found.

| { "code": "NotFound", "message": "Record not found.", "signature": { "dateTime": "August 31, 2022 3:24 PM", "message": "Certified by Verifik.co" } } | | 409 | Conflict | Some parameters are missing. | { "code": "MissingParameter", "message": "missing documentType\n. missing documentNumber\n" } | | 409 | Conflict | Invalid documentType for this query. | { "code": "MissingParameter", "message": "documentType must be one of: [ CC, , NIT, CE]" } |