🇨🇴 콜롬비아 — 선거청 신분증 유효성 증명서(CC)

엔드포인트

GET https://api.verifik.co/v2/co/registraduria/certificado

documentNumber, 발급일 date(DD/MM/YYYY). 동일 필드로 POST JSON 도 지원합니다. 이 서비스는 CC(시민권 신분증) 유효성 증명용입니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description
documentNumber	string	yes	공백·구두점 없는 CC 번호.
date	string	yes	문서 발급일 DD/MM/YYYY.

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/registraduria/certificado", {
	params: { documentNumber: "123456789", date: "10/10/2020" },
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/registraduria/certificado"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789", "date": "10/10/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

응답(Response)

200

{
	"data": {
		"codigoVerificacion": "ABC123XYZ",
		"novedad": "VIGENTE",
		"pdfBase64": "JVBERi0xLjQK...",
		"documento": {
			"cedula": "123456789",
			"fechaExpedicion": "10/10/2020",
			"lugarExpedicion": "BOGOTA D.C.",
			"nombre": "JUAN PEREZ"
		}
	},
	"signature": {
		"dateTime": "August 23, 2022 11:42 AM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

{
	"code": "MissingParameter",
	"message": "date format required: DD/MM/YYYY\n"
}

참고(Notes)

• date 는 발급일입니다 (생년월일 아님).
• GET / POST 동일 처리.
• pdfBase64 등은 민감정보입니다.