🇨🇴Colombian Citizen with Extra Data

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

Colombian Citizen Information with Extra Data

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

The Colombian Citizen Identification Information with Extra Data service provides comprehensive details about a Colombian citizen's identification document, extending beyond basic identification information. By supplying the identification number and type of document, you can retrieve not only the citizen’s full name, first name, last name, and identification number but also additional information such as date of birth, gender, and status of living.

Note: This service is specifically for Colombian identification documents. For verification of documents from other countries or different types of identification, please refer to the documentation for the relevant service.

Implementation

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