Colombian Citizen with Extra Data

Service to check a Colombian citizen using their citizenship identification card.

Endpoint

https://api.verifik.co/v2/co/cedula/extra 

Access detailed information about a Colombian citizen using their government-issued ID (Cédula de Ciudadanía). This API endpoint provides core details—full name, first name, last name, and ID number—along with extended private data, including date of birth, gender, and living status, for enhanced identity verification.

Key Use Case

Designed for businesses requiring in-depth identity checks for advanced KYC processes, fraud detection, or compliance in Colombia. Use responsibly due to the sensitive nature of the data returned.

Note: This endpoint is exclusive to Colombian ID documents (Cédula de Ciudadanía). For other countries or document types, please refer to our alternative validation services.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	¿Required?	Description	Example
documentType	String	True	Type of document. Valid parameter: CC.	CC
documentNumber	String	True	Document number of the person to consult, without spaces or periods.	123456789
date	String	True	Document issue date. Valid format: DD/MM/YYYY.	10/10/2020

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/cedula/extra',
  params: {documentType: 'CC', documentNumber: '123456789', date: '10/10/2020'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_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 = {}
conn.request("GET", "/v2/co/cedula/extra?documentType=CC&documentNumber=123456789&date=10/10/2020", 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/cedula/extra?documentType=CC&documentNumber=123456789&date=10%2F10%2F2020")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

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/cedula/extra?documentType=CC&documentNumber=123456789&date=10/10/2020');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setBody('');
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": "123456789",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "expeditionDate": "2022-05-10T00:00:00.000Z",
    "expeditionPlace": {
      "municipio": "BOGOTA D.C.",
      "departamento": "BOGOTA"
    },
    "dateOfBirth": "1999-05-07T00:00:00.000Z",
    "gender": "HOMBRE",
    "isAlive": true
  },
  "signature": {
    "dateTime": "August 23, 2022 11:42 AM",
    "message": "Certified by Verifik.co"
  }
}

404

{ 
    "code": "NotFound", 
    "message": "Record not found.", 
    "signature": { 
        "dateTime": "August 31, 2022 3:24 PM", 
        "message": "Certified by Verifik.co" 
        } 
}

409

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

409

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

409

{
    "code": "MissingParameter",
    "message": "date format required: DD/MM/YYYY\n"
}