Colombia — Certificado de vigencia de cédula (Registraduría)

Consulta el producto en API KYC Colombia.

Este endpoint devuelve el certificado de vigencia de la Cédula de Ciudadanía (CC) desde la Registraduría Nacional del Estado Civil, usando número de documento y fecha de expedición. La respuesta incluye campos estructurados extraídos del PDF oficial (incluido PDF en base64) e información como novedad (estado de vigencia en la consulta previa).

El flujo aplica a titulares de CC; la API valida solo documentNumber y date.

Qué devuelve la API

• Contexto de estado de vigencia (novedad) según la consulta upstream
• Datos del documento (número, expedición, lugar, nombre) cuando el parseo es correcto
• Código de verificación y PDF (pdfBase64) para auditoría
• Respuesta firmada por Verifik

Referencia de API

Endpoint

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

La misma integración está disponible como POST con cuerpo JSON con los mismos campos. GET usa parámetros de consulta como abajo.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentNumber	string	sí	Número de CC sin espacios ni signos.
date	string	sí	Fecha de expedición en DD/MM/AAAA.

Solicitud

JavaScript

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())

Respuesta

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"
}

Características

• Fecha de expedición en DD/MM/AAAA
• Datos del certificado en PDF con base64 cuando la generación tiene éxito
• GET y POST comparten el mismo manejador

Casos de uso

• KYC que requiere certificado de vigencia oficial para CC
• Reducción de fraude cuando la fecha de expedición debe coincidir con Registraduría

Notas

• date es la fecha de expedición del documento, no la fecha de nacimiento.
• Un formato incorrecto suele devolver 409 (MissingParameter).
• Problemas temporales de disponibilidad de la fuente pueden aparecer como 409 con códigos como Endpoint_out_of_service.
• GET y POST comparten el mismo manejador.
• Trata pdfBase64 y datos personales como sensibles; cumple la normativa colombiana y tus contratos.