Skip to main content

哥伦比亚 — 国民身份证高级核验 (CC)

用途： 将 哥伦比亚国民身份证（CC）证号 与官方来源核对，返回适用于 KYC/合规 的结构化身份信息（登记姓名、出生日期、签发地及签发时间；来源返回时可能包含性别、生存状态等），并包含可审计的签名字段。请求仅提供证号；签发日期在服务端完成解析（无需在请求中提供证件类型或签发日期）。信息粒度与 cédula extra 相当；单次额度消耗高于基础 /v2/co/cedula 路径，因含链式解析步骤。

API 参考​

端点​

GET https://api.verifik.co/v2/co/cedula/premium

响应： 返回 data（针对所提交证号、来源可返回的本人属性）、signature（对本响应载荷的认证元数据）、id（请求标识符）。HTTP 404 表示在本工作流下无法为该证号组装完整身份记录。HTTP 409 表示在进入上游处理前未通过输入校验（例如 documentNumber 长度）。每请求额度高于基础 /v2/co/cedula（链式解析）。仅 CC；证号一般 5～10 位数字（规范化后）。

请求头​

名称值
Acceptapplication/json
AuthorizationBearer <token>

参数​

名称类型必填说明
documentNumberstring是哥伦比亚 CC 国民身份证证号。非数字字符会在服务端剥除。规范化后须为 5～10 位数字，以通过接口校验。

请求示例​

import axios from "axios";

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

响应​

示例结构（占位字段，非真实人物）：

{
	"data": {
		"arrayName": ["GIVEN", "MIDDLE", "PATERNAL", "MATERNAL"],
		"dateOfBirth": "1990-05-20",
		"documentNumber": "1234567890",
		"documentType": "CC",
		"expeditionDate": "2015-08-12",
		"expeditionPlace": {
			"municipio": "示例市",
			"departamento": "示例省"
		},
		"firstName": "GIVEN MIDDLE",
		"fullName": "GIVEN MIDDLE PATERNAL MATERNAL",
		"gender": "HOMBRE",
		"isAlive": true,
		"lastName": "PATERNAL MATERNAL"
	},
	"signature": {
		"dateTime": "April 21, 2026 9:34 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "XXXXX"
}

字段名称及取值范围以官方上游数据为准。

相关​