Verificación de Cédula de Ciudadanía (CC)en Colombia

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.

La Cédula de Ciudadanía (CC) acredita la identidad de una persona con un nivel oficial y confiable

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

Cada país asigna un nombre diferente al Documento de Identidad, con su propio diseño, pero todas comparten datos clave para identificar a una persona.

Explora Documentación por País

Verifica la Cédula de Ciudadania (CC) colombiana para cumplimiento KYC/AML

Consulte en tiempo real por medio de API o Web app

Evita fraudes y riesgos financieros, mantén tu empresa protegida.

Verificación 100% confiable con fuentes oficiales.

Ejemplo de cédula de identidad de Venezuela Ejemplo de documento de identidad de Uruguay Ejemplo de cédula de identidad de Nicaragua Ejemplo de cédula de identidad de Ecuador Ejemplo de cédula de identidad de Chile Ejemplo de cédula de identidad de Costa Rica Ejemplo de documento de identidad de Brasil Ejemplo de cédula de identidad de Bolivia Ejemplo de cédula de identidad de Venezuela Ejemplo de documento de identidad de Uruguay Ejemplo de cédula de identidad de Nicaragua Ejemplo de cédula de identidad de Ecuador Ejemplo de cédula de identidad de Chile Ejemplo de cédula de identidad de Costa Rica Ejemplo de documento de identidad de Brasil Ejemplo de cédula de identidad de Bolivia

¿Qué ofrece Verifik?

Cédula de ciudadanía colombiana con sus datos resaltados

OCR de alta precisión

Extraemos automáticamente los datos visibles del documento.

Validación de una cédula colombiana con el resultado: la información no coincide

Contraste con Fuentes Oficiales

Automatiza y verifica la información en tiempo real.

Cédula de ciudadanía colombiana enmarcada para su escaneo

Análisis documental (IA)

Detectamos ediciones, montajes y documentos manipulados.

Pantalla de consulta en el celular con captura del rostro del usuario

Comparación facial + Liveness

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

Diagrama de conexión mediante la API de Verifik

Integración por API

Ideal para empresas que requieren flujos de onboarding o validación masiva.

Toma de decisiones financieras

Procesos de contratación

Envíos, entregas o reservas

Registros de usuarios

Cumplimiento regulatorio KYC/AML

¿Por qué es importante validar estos documentos?

Ayudamos a las mejores empresas a validar correctamente sus clientes para mejorar su linea de negocio.

Verifik reduce riesgos y acelera la verificación en industrias como fintech, seguros, movilidad, e-commerce y más.

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.

API para validar cédula en Colombia: qué verifica en 2026

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.

Endpoint y parámetros para validar cédula por API

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ámetroTipoObligatorioDescripción
documentTypestringSíCC o PPT (no NIT)
documentNumberstringSíDe 5 a 10 caracteres, sin espacios ni puntos

Código para validar cédula colombiana por API

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

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"

Node.js

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

Python

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

Respuesta de la API de cédula: ejemplo y campos

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"
}
CampoQué contiene
fullNameNombre completo del titular
firstName / lastNameNombres y apellidos
arrayNameCada nombre y apellido como elemento de una lista
documentType / documentNumberEl documento consultado
signatureFecha y hora de la consulta con el mensaje «Certified by Verifik.co»
idIdentificador de la consulta para tu pista de auditoría

Códigos de error de la API de validación de cédula

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ódigoRespuestaQué hacer
200Consulta exitosaCompara el nombre y guarda id y signature
404NotFound: «Record not found.»Pide al usuario que revise el número y el tipo de documento
409MissingParameter: «missing documentType» o «missing documentNumber»Envía ambos parámetros
409MissingParameter: «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]"
}

Vigencia de la cédula: certificado de la Registraduría por API

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.

Cómo usar la validación de cédula en tu onboarding

  1. Pide el tipo y el número de documento en el formulario de registro.
  2. Llama a /v2/co/cedula y compara fullName con el nombre que escribió el usuario.
  3. Si tienes la fecha de expedición, confirma la vigencia con el certificado de la Registraduría.
  4. Para saber que quien se registra es el titular, agrega una selfie con prueba de vida y comparación facial contra el documento.
  5. Según tu riesgo, consulta antecedentes de la Policía por API y listas restrictivas.
  6. Guarda el 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.

Preguntas frecuentes

➖

¿Qué devuelve la API de validación de cédula en Colombia?

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.

➕

¿Qué documentos acepta el endpoint /v2/co/cedula?

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.

➕

¿Cómo sé si una cédula está vigente?

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.

➕

¿Qué significa un error 404 al validar una cédula?

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.

➕

¿Qué autenticación usa la API de Verifik?

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.

➕

¿La validación de cédula confirma que quien se registra es el titular?

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.

➕

¿Cómo trata Verifik los datos personales de la consulta?

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.

Valida cédulas de identidad de toda Latinoamérica desde una sola plataforma.

Descubre cómo Verifik puede automatizar tus procesos, reducir el fraude y mejorar la experiencia de tus usuarios.