Colombia — PPT (Permiso de Protección Temporal)

Validación del PPT ante Migración Colombia para KYC, programas sociales y cumplimiento.

Qué devuelve la API

• Estado (p. ej. VIGENTE) y fechas clave
• Nombre estructurado y metadatos del permiso
• Respuesta firmada; caché opcional

Referencia de API

Endpoint

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

También existe POST con el mismo cuerpo JSON. GET usa query.

Encabezados

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentNumber	string	sí	Número del PPT sin espacios ni puntos.
expeditionDate	string	sí	Fecha de expedición en DD/MM/AAAA (ej. 07/03/2022).

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/foreigner-id/ppt", {
	params: {
		documentNumber: "123456789",
		expeditionDate: "07/03/2022",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/foreigner-id/ppt"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789", "expeditionDate": "07/03/2022"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

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": "expeditionDate must be a valid date in DD/MM/YYYY format"
}

Características

• Consulta de PPT ante Migración Colombia
• Campos de vigencia y fechas cuando la fuente los expone

Casos de uso

• Programas de asistencia y empleo que requieran estado migratorio
• Onboarding financiero sujeto a verificación de PPT

Notas

• expeditionDate debe estar en DD/MM/AAAA.
• GET y POST comparten la misma lógica.
• Cambios en el portal pueden producir 404 / 500.