Contraloría Certificate

API Reference

Endpoint

https://api.verifik.co/v2/co/contraloria/certificado

The service lets you verify the certificate of good conduct issued by the Contraloría General de Colombia by entering the document type and number, and returns the query date together with the certificate as a base64-encoded PDF. This service is ideal for quickly confirming the good standing status of a Colombian company or individual.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

info

For the complete list of supported Document Types and their specific mandatory parameters, please visit the Document Types guide.

Name	Type	Required	Description
documentType	string	Yes	Type of document. Valid parameters: CC, CE, PA, PEP.
documentNumber	string	Yes	Document number of the person to consult, without spaces or points.

Request

JavaScript

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: 'Bearer <your_token>'
  }
};

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

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer <your_token>'
}
conn.request("GET", "/v2/co/contraloria/certificado?documentType=CC&documentNumber=123456789", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/contraloria/certificado?documentType=CC&documentNumber=123456789")!,
                         timeoutInterval: Double.infinity)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <your_token>", forHTTPHeaderField: "Authorization")

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/contraloria/certificado?documentType=CC&documentNumber=123456789');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setHeader('Accept', 'application/json');
$request->setHeader('Authorization', 'Bearer <your_token>');
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

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

404

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

409 (Missing Parameters)

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

409 (Invalid Document Type)

{
"code": "MissingParameter",
"message": "documentType must be one of: [CC, CE, PA, PEP]"
}