Colombia — PPT (Temporary Protection Permit)

Verifik validates PPT (Permiso de Protección Temporal) records published by Migración Colombia for KYC, eligibility, and compliance workflows.

What this API returns

• Status (e.g. VIGENTE) and key dates, including expedition and expiration
• Structured name fields and PPT document metadata
• Responses are signed and may be cached

API reference

Endpoint

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

The same integration is available as POST with a JSON body containing the same fields. GET uses query parameters as shown below.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Document requirements

Who is this for? Venezuelan nationals in Colombia who hold a Permiso de Protección Temporal (PPT) when you need immigration status from Migración Colombia (e.g. VIGENTE, expiration dates).

Field	Guidance
documentNumber	PPT number, digits only. In Colombia the permit number is usually up to 7 digits. Some systems (SENA, payroll) display it zero-padded to 15 characters — send the numeric value your records use. Example from Migración: 2081381.
expeditionDate	Issue date on the PPT, format DD/MM/YYYY (e.g. 07/03/2022). Required.

Also available: name-style lookup via /v2/co/cedula with documentType=PPT (5–10 digit validation, no expedition date).

Full comparison: Colombia identity documents guide.

Parameters

name	type	required	description
documentNumber	string	yes	PPT number, digits only. Typically up to 7 digits (some systems pad to 15). Example: 2081381.
expeditionDate	string	yes	Issue date in DD/MM/YYYY format (e.g. 07/03/2022). Must match the document.

Request

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

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

Features

• Official PPT lookup against Migración Colombia’s public consultation flow
• Validity and lifecycle fields when returned by the source

Use cases

• Humanitarian and social programs that require proof of temporary protection status
• Employer and financial onboarding where Colombian immigration checks apply

Notes

• expeditionDate must match DD/MM/YYYY; wrong formats typically return 409.
• GET and POST are both routed to the same handler; use POST if you prefer a JSON body.
• For name / identity data without expedition date, try /v2/co/cedula with documentType=PPT. See the documents guide.
• Upstream portal or parsing changes may surface 404 / 500 when no row is found or the source is unavailable.