Valida cédulas de ciudadanía en Colombia en tiempo real con acceso a fuentes oficiales. API para verificación de identidad, cumplimiento KYC y prevención de fraude.

Colombia emite la cédula de ciudadanía como documento para identificar a sus ciudadanos.




Extraemos automáticamente los datos visibles del documento.

Automatiza y verifica la información en tiempo real.

Detectamos ediciones, montajes y documentos manipulados.

Confirmación biométrica para asegurar que la persona es real.

Ideal para empresas que requieren flujos de onboarding o validación masiva.
Actualizado: 14 de noviembre de 2026 · revisado contra la documentación oficial de la API.
Respuesta corta: Para validar una cédula colombiana por API, envía GET /v2/co/cedula con documentType (CC o PPT), el número sin puntos y tu token Bearer. Verifik consulta la Registraduría y devuelve el nombre completo con una firma fechada. Para confirmar la vigencia, usa el certificado de la Registraduría con la fecha de expedición.
El endpoint de cédula de Verifik consulta la Registraduría Nacional del Estado Civil y confirma que el número existe y a qué nombre está. Admite dos documentos: la cédula de ciudadanía (CC) y el Permiso por Protección Temporal (PPT) de migrantes venezolanos. No cubre la cédula de extranjería, que tiene su propio endpoint (lo explicamos en la guía para verificar cédulas de extranjería), ni el NIT de empresas.
Con la respuesta puedes comparar el nombre que declara tu usuario con el registrado, bloquear números inexistentes antes de abrir una cuenta y guardar un identificador de consulta como evidencia para tu auditoría KYC.
La ruta es GET https://api.verifik.co/v2/co/cedula (también acepta POST con los mismos campos). Autenticas con el encabezado Authorization: Bearer <token> y pides JSON con Accept: application/json.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
documentType | string | Sí | CC o PPT (no NIT) |
documentNumber | string | Sí | De 5 a 10 caracteres, sin espacios ni puntos |
Los tres ejemplos hacen la misma consulta. Cambia el número de prueba por el de tu usuario y guarda el token en una variable de entorno, nunca en el código del cliente.
curl -G "https://api.verifik.co/v2/co/cedula" \
-H "Accept: application/json" \
-H "Authorization: Bearer $VERIFIK_TOKEN" \
--data-urlencode "documentType=CC" \
--data-urlencode "documentNumber=123456789"import axios from "axios";
const { data } = await axios.request({
method: "GET",
url: "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.fullName, data.id);import os, requests
url = "https://api.verifik.co/v2/co/cedula"
headers = {
"Accept": "application/json",
"Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}",
}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params, timeout=30)
print(r.status_code, r.json())Una consulta exitosa devuelve código 200 con los nombres del titular, el documento consultado y una firma de Verifik. Los datos del ejemplo son ficticios.
{
"data": {
"arrayName": [
"JUAN",
"CARLOS",
"PEREZ",
"GOMEZ"
],
"documentNumber": "123456789",
"documentType": "CC",
"firstName": "JUAN CARLOS",
"fullName": "JUAN CARLOS PEREZ GOMEZ",
"lastName": "PEREZ GOMEZ"
},
"signature": {
"dateTime": "November 14, 2026 9:15 AM",
"message": "Certified by Verifik.co"
},
"id": "CC01A"
}| Campo | Qué contiene |
|---|---|
fullName | Nombre completo del titular |
firstName / lastName | Nombres y apellidos |
arrayName | Cada nombre y apellido como elemento de una lista |
documentType / documentNumber | El documento consultado |
signature | Fecha y hora de la consulta con el mensaje «Certified by Verifik.co» |
id | Identificador de la consulta para tu pista de auditoría |
La documentación lista estos casos. Ninguno debería traducirse en un rechazo automático sin revisión: un 404 puede ser un número mal digitado.
| Código | Respuesta | Qué hacer |
|---|---|---|
| 200 | Consulta exitosa | Compara el nombre y guarda id y signature |
| 404 | NotFound: «Record not found.» | Pide al usuario que revise el número y el tipo de documento |
| 409 | MissingParameter: «missing documentType» o «missing documentNumber» | Envía ambos parámetros |
| 409 | MissingParameter: «documentType must be one of: [CC,PPT]» | Usa CC o PPT; para extranjería usa su endpoint |
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [CC,PPT]"
}Si además necesitas saber si la cédula está vigente, GET /v2/co/registraduria/certificado recibe el número y la fecha de expedición (no la de nacimiento) en formato DD/MM/AAAA. Devuelve el estado en novedad (por ejemplo, VIGENTE), un código de verificación y el certificado en PDF codificado en base64 (documentación del certificado).
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"} # issue date, DD/MM/YYYY
r = requests.get(url, headers=headers, params=params, timeout=60)
print(r.status_code, r.json())
{
"data": {
"codigoVerificacion": "ABC123XYZ",
"novedad": "VIGENTE",
"pdfBase64": "JVBERi0xLjQK...",
"documento": {
"cedula": "123456789",
"fechaExpedicion": "10/10/2020",
"lugarExpedicion": "BOGOTA D.C.",
"nombre": "JUAN CARLOS PEREZ GOMEZ"
}
},
"signature": {
"dateTime": "November 14, 2026 9:16 AM",
"message": "Certified by Verifik.co"
}
}Si la fecha no viene en DD/MM/AAAA, la API responde 409 MissingParameter. Cuando la fuente no está disponible temporalmente puede responder 409 con Endpoint_out_of_service: reintenta más tarde en vez de rechazar al usuario. Trata el PDF y los datos personales como información sensible.
/v2/co/cedula y compara fullName con el nombre que escribió el usuario.id y la signature de cada respuesta en el expediente del cliente.El flujo completo de KYC para Colombia, con todos los endpoints, está en nuestra guía de API KYC para Colombia, y las obligaciones nuevas contra la suplantación están resumidas en la página de la Ley 2573 de 2026. Si prefieres una explicación sin código, lee la guía de verificación con cédula de ciudadanía.
¿Listo para probar? Crea tu cuenta gratis en Verifik, genera tu token y haz tu primera validación de cédula desde tu código.
El nombre completo del titular, sus nombres y apellidos por separado, el tipo y número de documento, una firma de Verifik con fecha y hora y un identificador de consulta que puedes guardar como evidencia.
La cédula de ciudadanía (CC) y el Permiso por Protección Temporal (PPT). La cédula de extranjería tiene su propio endpoint y el NIT de empresas no se consulta en esta ruta.
Con el certificado de la Registraduría (GET /v2/co/registraduria/certificado). Envías el número y la fecha de expedición en formato DD/MM/AAAA y la respuesta trae el estado en el campo novedad, por ejemplo VIGENTE.
Que la fuente no encontró un registro para ese número (NotFound, «Record not found.»). Suele deberse a un número mal digitado o a un tipo de documento equivocado, así que conviene pedir al usuario que lo revise antes de rechazarlo.
Un token en el encabezado Authorization: Bearer. Lo generas al crear tu cuenta en Verifik y debe quedarse en tu servidor, nunca en el código del navegador o de la app.
No por sí sola: confirma que el número existe y a qué nombre está. Para saber que la persona es el titular, combínala con una selfie con prueba de vida y comparación facial contra el documento.
Según su documentación, Verifik procesa los datos conforme a la Ley 1581 de 2012 de protección de datos personales. Tu empresa debe contar con la autorización del titular para consultar su información.