Skip to main content

🇨🇴 哥伦比亚公民（CC / PPT）

端点​

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

GET https://verifik.app/v2/co/cedula 为同一路径。亦支持 POST 提交相同字段。

标头​

NameValue
Acceptapplication/json
AuthorizationBearer <token>

证件要求​

适用对象： 持有 Cédula de Ciudadanía（CC）的哥伦比亚公民，或需要从民事登记数据源获取姓名与身份数据的 Permiso de Protección Temporal（PPT）委内瑞拉移民。

类型持有人documentType哥伦比亚常见长度本 API 接受
CC哥伦比亚公民CC3–10 位（常见 8 或 10 位 NUIP）5–10 位，仅数字
PPT委内瑞拉移民（本路径姓名查询）PPT最多 7 位5–10 位，仅数字

填写 documentNumber： 仅数字 — 无点、空格或连字符。CC 示例：1032386359。

请使用其他端点：

  • CE（Cédula de Extranjería）→ 哥伦比亚 CE（/v2/co/foreigner-id/ce + expeditionDate）
  • PPT 移民状态（VIGENTE / 到期）→ 哥伦比亚 PPT（/v2/co/foreigner-id/ppt + expeditionDate）
  • 移民 PEP（Permiso Especial de Permanencia，15 位）→ 哥伦比亚 PEP

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

参数​

nametyperequireddescription
documentTypestringyesCC（Cédula de Ciudadanía）或 PPT（Permiso de Protección Temporal）。NIT、CE 及移民 PEP 不接受 — 见 证件指南。
documentNumberstringyes证件号码，仅数字（无空格或句点）。5–10 位（API 校验）。CC 常见 8 或 10 位；PPT 在官方记录中常为最多 7 位。示例：1032386359。

动态定价​

本端点参与 Verifik 的动态查询架构。多数情况下按 /v2/co/cedula 的标准费率计费。当标准验证路径未返回匹配时，可能自动运行扩展验证路径；若该路径返回 HTTP 200，则适用动态定价，积分按该端点系列的高级层级扣除，而非标准层级。

价格预期： 从账户标准费率 · 最高至高级费率（见您的套餐、Postman 或客户端面板）。

flowchart LR
  client[客户端调用 /v2/co/cedula]
  standardPath[标准验证路径]
  extendedPath[扩展验证路径]
  chargeStandard[按标准费率计费]
  chargePremium[按高级费率计费 — 动态定价]

  client --> standardPath
  standardPath -->|"匹配 HTTP 200"| chargeStandard
  standardPath -->|"无匹配"| extendedPath
  extendedPath -->|"匹配 HTTP 200"| chargePremium
  extendedPath -->|"无匹配 HTTP 404"| chargeStandard

可选计费透明： 在请求中传递查询参数 includeCost=true。扣除积分时，若适用动态定价，响应可能包含 billing 对象：

"billing": {
  "dynamicQueryApplied": true,
  "adjustmentType": "dynamic_query_premium",
  "standardCredits": 0.3,
  "chargedCredits": 2,
  "standardFeatureCode": "colombia_api_identity_lookup",
  "billedFeatureCode": "colombia_api_identity_lookup_premium"
}

积分数量为示例；实际值取决于您的套餐。

请求​

import axios from "axios";

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

响应​

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"firstName": "Juan",
		"lastName": "Pérez",
		"fullName": "Juan Pérez",
		"status": "valid"
	},
	"signature": {
		"message": "Certified by Verifik.co",
		"dateTime": "January 16, 2024 3:44 PM"
	},
	"id": "AB123"
}

备注​