Colombia - PPT

Endpoint

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

Verificar el estado de un Permiso por Protección Temporal (PPT) emitido por Migración Colombia. Este servicio API permite confirmar si un PPT está aprobado y listo para entrega en un Centro Facilitador de Servicios Migratorios, asegurando que el titular del documento pueda acceder a los servicios requeridos. Ideal para empresas y organizaciones que necesitan validar el estado migratorio para cumplimiento, verificaciones de elegibilidad o provisión de servicios en Colombia.

Perfecto para organizaciones que realizan verificación de estado migratorio, como para empleo, servicios financieros o programas de ayuda humanitaria, particularmente para migrantes venezolanos en Colombia.

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentNumber	string	Sí	Número de documento sin espacios ni puntos
expeditionDate	string	Sí	Fecha cuando se generó el documento

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/foreigner-id/ppt',
  params: {expeditionDate: '07/03/2022', documentNumber: '123456789'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token_verifik>'
  }
};

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

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/co/foreigner-id/ppt?documentNumber=123456789&expeditionDate=10/10/2024", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/foreigner-id/ppt?documentNumber=123456789&expeditionDate=10%2F10%2F2024")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/co/foreigner-id/ppt?documentNumber=123456789&expeditionDate=10/10/2024', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

Response

200

{
    "data": {
        "arrayName": [
            "JUAN",
            "MIGUEL",
            "CAMERO",
            "MORALES"
        ],
        "documentNumber": "2081381",
        "documentType": "PPT",
        "expeditionDate": "07/03/2022",
        "expirationDate": "30/05/2031",
        "firstName": "JUAN MIGUEL",
        "fullName": "JUAN MIGUEL CAMERO MORALES",
        "lastName": "CAMERO MORALES",
        "status": "VIGENTE"
    },
    "signature": {
        "dateTime": "May 13, 2025 11:52 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "JD24J"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
    "code": "MissingParameter",
    "message": "missing expeditionDate\n"
}

Features

• Verificación de Estado PPT: Verificar el estado de Permisos por Protección Temporal emitidos por Migración Colombia
• Validación de Estado Migratorio: Confirmar si el PPT está aprobado y listo para entrega
• Datos de Identidad Completos: Retorna nombre completo, primer nombre, apellido, detalles del documento y estado
• Respuesta Estructurada: Formato de datos organizado para fácil integración
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Manejo de Errores: Respuestas de error comprensivas para varios escenarios