Colombian Foreigner ID (CE)

Service to query foreigners using the foreigner identification card.

Endpoint

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

Verify the Cédula de Extranjería (CE), the official identification document for foreigners residing in Colombia. This API endpoint allows you to retrieve authenticated details, including the holder’s first name, last name, document number, and expiration date, streamlining identity verification for compliance and data processing.

Key Use Case

Perfect for businesses and organizations needing to validate the residency status of foreigners in Colombia, such as for employment, financial services, or legal compliance.

Important Notes

• The Cédula de Extranjería (CE) is issued by Migración Colombia for foreigners residing in the country. For other document types, please refer to our alternative validation services.

• Use of this service is restricted to authorized entities or direct permission from the end-user. The data provided is subject to Colombian privacy laws and should be handled responsibly.

• Always cross-check with the physical CE document to confirm the information retrieved.

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