🇨🇴 哥伦比亚 — 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>

参数

name	type	required	description
documentNumber	string	yes	PPT 号码，不含空格。
expeditionDate	string	yes	签发日期 DD/MM/YYYY。

请求

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。