🇨🇴 Colômbia — PPT (proteção temporária)

Endpoint

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

documentNumber e expeditionDate (DD/MM/YYYY). POST com o mesmo JSON.

Cabeçalhos

Name	Value
Accept	application/json
Authorization	Bearer <token>

Requisitos do documento

Para quem? Nacionais venezuelanos na Colômbia com Permiso de Protección Temporal (PPT) quando você precisa do status migratório da Migración Colombia (ex. VIGENTE, datas de vencimento).

Campo	Orientação
documentNumber	Número PPT, somente dígitos. Na Colômbia o permiso costuma ter até 7 dígitos. Alguns sistemas (SENA, folha) exibem preenchido até 15 caracteres — envie o valor numérico dos seus registros. Exemplo Migración: 2081381.
expeditionDate	Data de expedição DD/MM/AAAA (ex. 07/03/2022). Obrigatória.

Também disponível: consulta de nome via /v2/co/cedula com documentType=PPT (validação 5–10 dígitos, sem data de expedição).

Comparação completa: Guia de documentos de identidade.

Parâmetros

name	type	required	description
documentNumber	string	yes	Número PPT, somente dígitos. Geralmente até 7 dígitos (alguns sistemas preenchem até 15). Exemplo: 2081381.
expeditionDate	string	yes	Data de expedição DD/MM/AAAA (ex. 07/03/2022). Deve coincidir com o documento.

Requisição

Node.js

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

Resposta

200

{
	"data": {
		"documentType": "PPT",
		"documentNumber": "2081381",
		"status": "VIGENTE",
		"fullName": "JUAN MIGUEL CAMERO MORALES"
	},
	"signature": {
		"message": "Certified by Verifik.co",
		"dateTime": "May 13, 2025 11:52 PM"
	},
	"id": "JD24J"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "expeditionDate must be a valid date in DD/MM/YYYY format"
}

Notas

• Data em DD/MM/YYYY.
• GET e POST equivalentes.
• Falhas no portal podem gerar 404 / 500.