The comptroller certificate service enables you to verify a certificate of good standing issued by the Colombian Comptroller's Office. By providing the document type and number, you can receive the search date and a base64-encoded PDF of the certificate. This service is ideal for quickly confirming the good standing status of a Colombian company or individual.

Parameters

Name Type ¿Required? Description Example
documentType String True Type of document. Valid parameters: CC, CE, PA, PEP. CC
documentNumber String True Document number of the person to consult, without spaces or points. 123456789

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/contraloria/certificado>',
  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": {
    "documentType": "CC",
    "documentNumber": "1020729123",
    "searchDate": "2022-03-22T15:37:23.487Z",
    "pdfBase64": "data:application/pdf;base64,STRING_BASE_64"
  },
  "signature": {
    "dateTime": "March 22, 2022 4:37 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: [DNIAR]" } | | 409 | Conflict | Endpoint out of service. | { "code": "Conflict", "message": "Endpoint out of service." } |