Colombian Citizen with Extra Data

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: '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 = {}
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."
}

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

409 - Invalid Date Format

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

Notes

• This endpoint requires the document issue date (date parameter) in DD/MM/YYYY format
• Only CC (Cédula de Ciudadanía) document type is supported
• Returns sensitive personal information including date of birth, gender, and living status
• Use responsibly and ensure compliance with data protection regulations