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>

Requisitos del documento

¿Para quién es? Nacionales venezolanos en Colombia con Permiso de Protección Temporal (PPT) cuando necesitas el estado migratorio ante Migración Colombia (p. ej. VIGENTE, fechas de vencimiento).

Campo	Orientación
documentNumber	Número del PPT, solo dígitos. Suele tener hasta 7 dígitos; algunos sistemas lo muestran rellenado a 15 caracteres. Ejemplo: 2081381.
expeditionDate	Fecha de expedición en DD/MM/AAAA (ej. 07/03/2022). Obligatoria.

También disponible: consulta de nombres vía /v2/co/cedula con documentType=PPT.

Guía completa: Guía de documentos.

Parámetros

name	type	required	description
documentNumber	string	sí	Número del PPT, solo dígitos. Normalmente hasta 7 dígitos (algunos sistemas rellenan a 15). Ejemplo: 2081381.
expeditionDate	string	sí	Fecha de expedición en DD/MM/AAAA (ej. 07/03/2022). Debe coincidir con el documento.

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.