🇨🇴Colombian Foreigner ID (CE)

Service to query foreigners using the foreigner identification card.

Colombian Foreigner ID (CE) Data Retrieval

GET - https://api.verifik.co/v2/co/foreigner-id/ce

The Colombian Foreigner ID (CE) Data Retrieval API enables you to effortlessly retrieve essential information from Colombian Foreigner Identification Cards. With this API, you can efficiently obtain verified data associated with a specific CE, facilitating various identity verification and data processing applications.

Implementation

Headers

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

Query Parameters

Name	Type	Required?	Description	Example
documentNumber	String	True	Document number of the person to consult, without spaces or periods.	123456789
expeditionDate	String	True	Expedition date of the document. Valid format: DD/MM/YYYY.	10/10/2022

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/foreigner-id/ce>',
  params: {documentNumber: '123456789', expeditionDate: '10/10/2024'},
  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/foreigner-id/ce?documentNumber=123456789&expeditionDate=10/10/2022", 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/foreigner-id/ce?documentNumber=123456789&expeditionDate=10%2F10%2F2022")!,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/foreigner-id/ce?documentNumber=123456789&expeditionDate=10/10/2022');
$request->setMethod(HTTP_Request2::METHOD_GET);
$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": {
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "documentNumber": "123456789",
    "documentType": "CE",
    "expirationDate": "07/03/2017",
    "firstName": "MATEO",
    "fullName": "MATEO VERIFIK",
    "lastName": "VERIFIK",
    "status": "VENCIDO"
  },
  "signature": {
    "dateTime": "August 22, 2023 5:44 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "har4z"
}

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 expeditionDate\n. missing documentNumber\n"
}