🇨🇴 哥伦比亚 — PPT（临时保护许可）

端点

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

使用 documentNumber 与签发日期 expeditionDate（DD/MM/YYYY）。也可用 POST 提交相同 JSON 字段。

标头

Name	Value
Accept	application/json
Authorization	Bearer <token>

证件要求

适用对象： 需要从 Migración Colombia 查询移民状态（如 VIGENTE、到期日）的 Permiso de Protección Temporal（PPT）持有委内瑞拉国民。

字段	说明
documentNumber	PPT 号码，仅数字。在哥伦比亚许可号通常最多 7 位。部分系统（SENA、工资）显示为 15 位补零 — 发送您记录中的数值。Migración 示例：2081381。
expeditionDate	签发日期 DD/MM/YYYY（如 07/03/2022）。必填。

另有： 通过 /v2/co/cedula 设 documentType=PPT 进行姓名型查询（5–10 位校验，无需签发日期）。

完整对照：身份证件指南。

参数

name	type	required	description
documentNumber	string	yes	PPT 号码，仅数字。通常最多 7 位（部分系统补零至 15 位）。示例：2081381。
expeditionDate	string	yes	签发日期 DD/MM/YYYY（如 07/03/2022）。须与证件一致。

请求

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

响应

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

说明

• 日期格式为 DD/MM/YYYY。
• GET 与 POST 行为一致。
• 上游不可用可能出现 404 / 500。