🇨🇴 コロンビア — PEP（特別滞在許可）

エンドポイント

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

documentNumber と発行日 expeditionDate（DD/MM/YYYY）で照会します。同じフィールドの POST JSON にも対応します。

ヘッダー(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

パラメータ(Parameters)

name	type	required	description
documentNumber	string	yes	空白・句読点なしの PEP 番号。
expeditionDate	string	yes	発行日 DD/MM/YYYY。

リクエスト(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/foreigner-id/pep", {
	params: { documentNumber: "123456789", expeditionDate: "10/10/2024" },
	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/pep"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789", "expeditionDate": "10/10/2024"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

レスポンス(Response)

200

{
	"data": {
		"documentType": "PEP",
		"documentNumber": "123456789012345",
		"status": "VIGENTE",
		"fullName": "MATEO VERIFIK"
	},
	"signature": {
		"message": "Certified by Verifik.co",
		"dateTime": "August 22, 2023 8:02 PM"
	},
	"id": "tnlkb"
}

404

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

409

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

備考(Notes)

• 日付は DD/MM/YYYY 形式です。
• GET / POST は同じ処理です。
• 上流の都合で 404 / 500 になる場合があります。