Verificación de identidad en Colombia
La API de Verificación de Identidad de Verifik te ayuda a autenticar ciudadanos colombianos usando datos oficiales del gobierno. Está diseñada para agilizar tus procesos de KYC (Conozca a su Cliente), prevenir fraudes y asegurar el cumplimiento normativo sin complicaciones.
Creamos esta integración para empresas que necesitan una forma rápida, segura y automatizada de confirmar la verdadera identidad de usuarios, empleados o clientes.
¿Qué valida esta API?
Nuestra API se conecta directamente con registros oficiales para validar:
- Nombre Completo y Número de ID: Soporta Cédula de Ciudadanía y Cédula de Extranjería.
- Estado del Documento: Verifica el estado actual en la base de datos de la Registraduría Nacional del Estado Civil.
- Expedición y Vigencia: Confirma la fecha de expedición y si el documento está actualmente vigente.
- Coincidencia de Identidad: Verifica que el nombre proporcionado coincida con el número de identificación.
Al verificar estos detalles, puedes tener la certeza de que la persona con la que tratas es real y posee un documento válido, reduciendo significativamente el riesgo de suplantación y fraude.
Referencia de API
Endpoint
https://api.verifik.co/v2/co/cedula
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parámetros
| Name | Type | Required | Description |
|---|---|---|---|
documentType | string | Sí | Uno de CC, PPT. |
documentNumber | string | Sí | Número de documento (sin espacios o puntos). |
Solicitud
- Node.js
- Python
import axios from "axios";
const options = {
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}`,
},
};
const { data } = await axios.request(options);
console.log(data);
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)
print(r.json())
Respuesta
- 200
- 404
- 409
- 409 - Tipo de documento inválido
- 409 - Falta número de documento
{
"data": {
"arrayName": [
"JULIO",
"CESAR",
"CABANA",
"CONTRERAS"
],
"documentNumber": "1121329662",
"documentType": "CC",
"firstName": "JULIO CESAR",
"fullName": "JULIO CESAR CABANA CONTRERAS",
"lastName": "CABANA CONTRERAS"
},
"signature": {
"dateTime": "October 8, 2025 8:21 PM",
"message": "Certified by Verifik.co"
},
"id": "I70IL"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [CC,PPT]"
}
{
"code": "MissingParameter",
"message": "missing documentNumber\n"
}
Notas
- Usa
documentType=CCpara cédula;PPTpara Permiso por Protección Temporal.
Casos de Uso Comunes
- Fintech y Banca: Verifica identidades al instante durante la apertura de cuentas o solicitudes de crédito.
- E-commerce y Delivery: Autentica usuarios y repartidores antes de que se activen en tu plataforma.
- Recursos Humanos y Reclutamiento: Valida documentos de candidatos como parte de tu proceso de contratación.
- Seguros y Salud: Confirma identidades antes de emitir pólizas o proporcionar beneficios médicos.
Fuentes Oficiales y Confiabilidad
Nos conectamos directamente con la Registraduría Nacional del Estado Civil de Colombia para asegurar que recibas información verificada y actualizada al minuto. Cada consulta se maneja con estricto cumplimiento de estándares de seguridad y regulatorios, incluyendo:
- Ley 1581 de 2012 (Protección de Datos Personales)
- Circulares KYC/AML de la UIAF y Superintendencia Financiera de Colombia
Beneficios Clave
- Cumplimiento Automatizado: Agiliza tus verificaciones KYC para prevenir fraudes sin agregar fricción a tus usuarios.
- Resultados Instantáneos: Procesa verificaciones en segundos, perfecto para onboarding digital en tiempo real.
- Datos Confiables: Confía en datos obtenidos directamente del gobierno colombiano.
- Integración Sencilla: Conéctate fácilmente vía nuestra API REST o usa nuestros SDKs compatibles.
Cumplimiento y Seguridad
Priorizamos la seguridad de tus datos. Verifik usa encriptación avanzada (HTTPS/TLS 1.3) y estándares estrictos de gestión de privacidad para garantizar la confidencialidad. Nuestro servicio está monitoreado 24/7 para disponibilidad y ofrece controles de acceso basados en roles para mantener seguro el acceso de tu equipo.
Sobre Verifik
Verifik es una plataforma líder en verificación de identidad, cumplimiento y prevención de fraude en América Latina. Nuestras APIs automatizan procesos de KYC, KYB, AML y validación biométrica, conectando empresas con fuentes oficiales de datos en Colombia, México, Perú, Chile, Uruguay y más allá.
APIs Relacionadas
Explora otros servicios de verificación en el ecosistema colombiano:
- Validación Vehicular RUNT: Consulta historial y propiedad de vehículos.
Preguntas Frecuentes (FAQ)
¿Esta API cumple con las leyes colombianas de protección de datos?
Sí, Verifik cumple con la Ley 1581 de 2012 (Habeas Data) y se adhiere a las regulaciones KYC/AML establecidas por la UIAF y la Superintendencia Financiera. Aseguramos que todos los datos se procesen de forma segura y con la debida autorización.
¿Qué tipos de documentos se pueden verificar?
La API soporta Cédula de Ciudadanía (CC) para ciudadanos colombianos y Permiso por Protección Temporal (PPT) para migrantes venezolanos.
¿Los datos se obtienen en tiempo real?
Sí, nuestra API se conecta directamente con fuentes oficiales del gobierno para proporcionar información en tiempo real y actualizada, asegurando que siempre tengas el estado más reciente de una identidad.