哥伦比亚 — 按姓名查询公民（SCCRC）

使用 姓名、性别 与 出生日期 搜索 Registraduría Nacional del Estado Civil 出生民事登记簿（SCCRC）。与按证件查询哥伦比亚公民不同，此端点为反向查询，可能返回多条匹配。

适用于已知个人身份属性但不知 NUIP/CC，或需要在证件核验前确认可能的登记命中时。

此 API 返回的内容

• matches — 民事登记命中数组（零条或多条）
• documentNumber、documentType — 记录中存在时的 NUIP/CC
• firstName、lastName、fullName、arrayName — 姓名组成部分
• sexo、serial — 性别与民事登记序列号
• oficina / expeditionPlace、fecha / dateOfBirth — 在有 Detalle 补全数据时可用
• recordType — REGISTRO CIVIL DE NACIMIENTO
• 已签名的 Verifik 响应包装

API 参考

端点

GET https://api.verifik.co/v2/co/cedula/by-name

需要按姓名查找出生登记候选时使用此端点。同一集成也支持带 JSON 正文的 POST。GET 使用如下所示的查询参数。

请求头（Headers）

Name	Value
Accept	application/json
Authorization	Bearer <token>

参数（Parameters）

name	type	required	description	Examples
primerNombre	string	yes	第一名（名）	MARIA
primerApellido	string	yes	第一姓	LOPEZ
sexo	string	yes	登记性别。允许：MASCULINO、FEMENINO（也可用 M / F）	FEMENINO
fecha	string	yes	出生日期，格式 DD/MM/YYYY	15/03/1990
segundoNombre	string	no	第二名	ELENA
segundoApellido	string	no	第二姓	GARCIA

请求（Request）

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/cedula/by-name", {
	params: {
		primerNombre: "MARIA",
		primerApellido: "LOPEZ",
		sexo: "FEMENINO",
		fecha: "15/03/1990",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/cedula/by-name"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {
	"primerNombre": "MARIA",
	"primerApellido": "LOPEZ",
	"sexo": "FEMENINO",
	"fecha": "15/03/1990",
}
r = requests.get(url, headers=headers, params=params)
print(r.json())

响应（Response）

200

{
	"data": {
		"matches": [
			{
				"documentType": "CC",
				"documentNumber": "10000001",
				"firstName": "MARIA ELENA",
				"lastName": "LOPEZ GARCIA",
				"fullName": "MARIA ELENA LOPEZ GARCIA",
				"arrayName": ["MARIA", "ELENA", "LOPEZ", "GARCIA"],
				"sexo": "FEMENINO",
				"serial": "0031010001",
				"oficina": "NOTARIA UNICA - BOGOTA D.C.",
				"expeditionPlace": "NOTARIA UNICA - BOGOTA D.C.",
				"fecha": "15/03/1990",
				"dateOfBirth": "15/03/1990",
				"recordType": "REGISTRO CIVIL DE NACIMIENTO"
			}
		],
		"recordType": "REGISTRO CIVIL DE NACIMIENTO"
	},
	"signature": {
		"dateTime": "July 20, 2026 12:00 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

{
	"code": "MissingParameter",
	"message": "missing primerNombre"
}

功能

• 针对 Registraduría SCCRC 出生登记的反向查询
• 响应始终为 { matches: [...] } 形态（请审查每一条命中）
• 可选第二名/第二姓可提高精确度
• GET 与 POST 共用同一处理程序

使用场景

• 根据已知姓名 + 出生日期恢复可能的 NUIP/CC 候选
• 仅有传记数据时对申请人进行预筛
• 对照民事登记命中交叉核验姓名拼写

说明（Notes）

• 请始终检查 matches；姓名查询可能返回一人以上。
• fecha 必须为 DD/MM/YYYY（出生日期）。
• 沙箱： 姓名查询映射到证件号 10000001–10000010 的固定档案。示例默认值：MARIA / LOPEZ / FEMENINO / 15/03/1990。
• 来源暂时不可用时可能表现为 409（Endpoint_out_of_service）。
• 相关：按证件查询哥伦比亚公民、按序列号查询民事登记、婚姻民事登记。