Colombian Citizen with Extra Data

Verifik's Identity Verification API helps you access detailed information about Colombian citizens using their government-issued ID (Cédula de Ciudadanía). It's designed to streamline your KYC (Know Your Customer) processes, prevent fraud, and ensure you meet all regulatory requirements effortlessly.

We built this integration for businesses requiring in-depth identity checks for advanced KYC processes, fraud detection, or compliance in Colombia. This 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.

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. Use responsibly due to the sensitive nature of the data returned.

What does this API validate?

Our API connects directly with official records to validate:

• Full Name & CC Number: Supports Cédula de Ciudadanía (CC) documents.
• Identity Match: Confirms that the name provided matches the CC number.
• Extended Personal Data: Returns date of birth, gender, and living status.
• Document Information: Validates document type, number, expedition date, and place.
• Demographic Data: Provides gender and living status verification.

By verifying these details, you can be confident that the person you're dealing with is real and holds a valid document, significantly lowering the risk of impersonation and fraud.

API Reference

Endpoint

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

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

---

Common Use Cases

• Advanced KYC Processes: Perform in-depth identity checks for enhanced compliance and fraud detection.
• Financial Services: Verify comprehensive identity data for banking and financial service applications.
• Employment Verification: Validate detailed personal information for hiring processes.
• Compliance & Due Diligence: Ensure compliance with Colombian regulations requiring extended identity data.
• Fraud Detection: Access extended data for advanced fraud prevention and risk assessment.

Official Sources & Reliability

We connect directly with official Colombian government sources to ensure you receive verified, up-to-the-minute information. Every query is handled with strict adherence to security and regulatory standards.

Key Benefits

• Automated Compliance: Streamline your KYC checks to prevent fraud without adding friction for your users.
• Extended Data Access: Get comprehensive identity information including date of birth, gender, and living status.
• Trusted Data: Rely on data sourced directly from official records.
• Easy Integration: Connect easily via our REST API or use our compatible SDKs.

Compliance & Security

We prioritize the safety of your data. Verifik uses advanced encryption (HTTPS/TLS 1.3) and strict privacy management standards to ensure confidentiality. Our service is monitored 24/7 for availability and offers role-based access controls to keep your team's access secure.

Important: This endpoint returns sensitive personal information. Use responsibly and ensure compliance with data protection regulations, including Colombian privacy laws.

About Verifik

Verifik is a leading platform for identity verification, compliance, and fraud prevention across Latin America. Our APIs automate KYC, KYB, AML, and biometric validation processes, connecting businesses with official data sources in Colombia, Mexico, Peru, Chile, Uruguay, Argentina, Brazil, and beyond.