Colombia — Cédula con datos extendidos (CC)

Verifik devuelve datos extendidos de la Cédula de Ciudadanía (CC) emparejando número y fecha de expedición con fuentes oficiales. Suele incluir nombre, expedición, fecha y lugar, fecha de nacimiento, género y estado vital cuando la fuente los provee.

Los datos son sensibles; úsalos solo donde la ley y tu política lo permitan.

Qué devuelve la API

• Identidad (partes del nombre, tipo y número de documento)
• Expedición (fecha y lugar coherentes con la consulta)
• Campos personales como fecha de nacimiento, género y estado vital cuando existan
• Respuesta firmada; puede haber caché

Referencia de API

Endpoint

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

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

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

nombre	tipo	requerido	descripción
documentType	string	sí	Debe ser CC.
documentNumber	string	sí	Número de CC sin espacios ni puntuación.
date	string	sí	Fecha de expedición del documento en DD/MM/AAAA.

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/cedula/extra", {
	params: {
		documentType: "CC",
		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/cedula/extra"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "date": "10/10/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"fullName": "MATEO VERIFIK",
		"firstName": "MATEO",
		"lastName": "VERIFIK",
		"arrayName": ["MATEO", "VERIFIK"],
		"expeditionDate": "2022-05-10T00:00:00.000Z",
		"expeditionPlace": {
			"municipio": "BOGOTA D.C.",
			"departamento": "BOGOTA"
		},
		"dateOfBirth": "1999-05-07T00:00:00.000Z",
		"gender": "HOMBRE",
		"isAlive": true
	},
	"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

• Solo CC en la capa de validación
• date = fecha de expedición en DD/MM/AAAA

Casos de uso

• KYC de mayor rigor con datos demográficos
• Antifraude cuando se conoce la fecha de expedición

Notas

• date es la fecha de expedición del documento, no la de nacimiento.
• Formato incorrecto → suele devolver 409.
• GET y POST comparten el mismo manejador.
• Puede tratarse de datos personales sensibles; cumple la normativa colombiana de privacidad.