The Special Stay Permit (PEP) ID Data Retrieval service provides a streamlined solution for accessing verified information from PEP (Permiso Especial de Permanencia) identification cards in Colombia. This service simplifies the retrieval of authenticated PEP-related data, making it easier to conduct identity verification and ensure compliance with various regulations.

Parametros

Name Type ¿Required? Description Example
documentNumber String True Document number of the person to consult, without spaces or periods. 123456789
expeditionDate String True Date when the document was generated. 10/10/2024

Implementation

Request

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 {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

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

Other responses

Code Description Response Body
404 Not Found Information not found.

| { "code": "NotFound", "message": "Record not found.", "signature": { "dateTime": "August 31, 2022 3:24 PM", "message": "Certified by Verifik.co" } } | | 409 | Conflict | Some parameters are missing.

| { "code": "MissingParameter", "message": "missing date\n. missing documentNumber\ n"} |