Special Stay Permit (PEP)

Service to check foreigners using the special residence permit.

Endpoint

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

Validate the Special Stay Permit (PEP - Permiso Especial de Permanencia) for Venezuelan citizens in Colombia. This API endpoint retrieves authenticated PEP data, including the permit holder’s full name, document number, expiration date, and status, simplifying identity verification for compliance, eligibility checks, or service provision.

Key Use Case

Ideal for organizations needing to verify the legal status of Venezuelan nationals in Colombia, such as for employment, financial services, or humanitarian programs.

Important Notes

• The PEP is a special permit issued by Migración Colombia exclusively for Venezuelan citizens. For other nationalities or document types, please refer to our alternative validation services.

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

• Always cross-check with the physical PEP 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 without spaces or periods	123456789
expeditionDate	String	True	Date when the document was generated	10/10/2024

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/foreigner-id/pep',
  params: {expeditionDate: '10/10/2024', documentNumber: '123456789'},
    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/pep?documentNumber=123456789&expeditionDate=10/10/2024", 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/pep?documentNumber=123456789&expeditionDate=10%2F10%2F2024")!,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/pep?documentNumber=123456789&expeditionDate=10/10/2024');
$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": "123456789012345",
    "documentType": "PEP",
    "expirationDate": "08/08/2018",
    "firstName": "MATEO",
    "fullName": "MATEO VERIFIK",
    "identification": "17609583",
    "lastName": "VERIFIK",
    "status": "VENCIDO"
  },
  "signature": {
    "dateTime": "August 22, 2023 8:02 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "tnlkb"
}

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