Ciudadano Colombiano

Notas

• Usa documentType=CC para cédula de ciudadanía y PPT para consulta de nombres con Permiso de Protección Temporal. Para CE, PEP migratorio o estado migratorio de PPT, consulta la guía de documentos.

---

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: Cédula de Ciudadanía (CC) o Permiso de Protección Temporal (PPT) en este endpoint — no Cédula de Extranjería (CE); usa Colombia CE.
• 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.

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.

¿Por qué me cobraron más que el precio listado de la cédula?

Cuando las rutas de verificación estándar en GET/POST /v2/co/cedula no devuelven coincidencia, Verifik puede intentar automáticamente una ruta de verificación extendida mediante Consulta Dinámica. Si esa ruta devuelve HTTP 200, aplica precio dinámico y se cobra el nivel premium de esa familia de endpoints. Envíe includeCost=true para ver un objeto billing en la respuesta, o revise su historial de solicitudes API.

Endpoint

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

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Requisitos del documento

¿Para quién es? Ciudadanos colombianos con Cédula de Ciudadanía (CC), o migrantes venezolanos con Permiso de Protección Temporal (PPT) cuando necesitas nombre y datos de identidad desde fuentes de registro civil.

Tipo	Quién lo tiene	documentType	Longitud típica en Colombia	Esta API acepta
CC	Ciudadanos colombianos	CC	3–10 dígitos (común: 8 o 10 NUIP)	5–10 dígitos, solo números
PPT	Migrantes venezolanos (nombres en esta ruta)	PPT	Hasta 7 dígitos	5–10 dígitos, solo números

Cómo ingresar documentNumber: solo dígitos — sin puntos, espacios ni guiones. Ejemplo CC: 1032386359.

Usa otro endpoint para:

• CE (Cédula de Extranjería) → Colombia CE (/v2/co/foreigner-id/ce + expeditionDate)
• Estado migratorio PPT (VIGENTE / vencimiento) → Colombia PPT (/v2/co/foreigner-id/ppt + expeditionDate)
• PEP migratorio (Permiso Especial de Permanencia, 15 dígitos) → Colombia PEP

Guía completa: Guía de documentos de identidad.

Parámetros

Name	Type	Required	Description
documentType	string	Sí	CC (Cédula de Ciudadanía) o PPT (Permiso de Protección Temporal). NIT, CE y PEP migratorio no se aceptan aquí — ver la guía de documentos.
documentNumber	string	Sí	Número del documento, solo dígitos (sin espacios ni puntos). 5–10 caracteres (validación API). La CC suele tener 8 o 10 dígitos; el PPT suele tener hasta 7 en registros oficiales. Ejemplo: 1032386359.

Precio dinámico

Este endpoint participa en la arquitectura de Consulta Dinámica de Verifik. En la mayoría de los casos pagas la tarifa estándar de /v2/co/cedula. Cuando las rutas de verificación estándar no devuelven coincidencia, puede ejecutarse automáticamente una ruta de verificación extendida. Si esa ruta devuelve HTTP 200, aplica precio dinámico y los créditos se deducen en el nivel premium de esta familia de endpoints, no en el nivel estándar.

Expectativa de precio: Desde tu tarifa estándar · hasta tarifa premium (consulta tu plan, Postman o el panel de cliente).

flowchart LR
  client[Cliente llama /v2/co/cedula]
  standardPath[Rutas de verificación estándar]
  extendedPath[Ruta de verificación extendida]
  chargeStandard[Cobro tarifa estándar]
  chargePremium[Cobro tarifa premium — precio dinámico]

  client --> standardPath
  standardPath -->|"Coincidencia HTTP 200"| chargeStandard
  standardPath -->|"Sin coincidencia"| extendedPath
  extendedPath -->|"Coincidencia HTTP 200"| chargePremium
  extendedPath -->|"Sin coincidencia HTTP 404"| chargeStandard

Transparencia de facturación (opcional): envía el parámetro de consulta includeCost=true. Cuando se cobren créditos, la respuesta puede incluir un objeto billing si aplica precio dinámico:

"billing": {
  "dynamicQueryApplied": true,
  "adjustmentType": "dynamic_query_premium",
  "standardCredits": 0.3,
  "chargedCredits": 2,
  "standardFeatureCode": "colombia_api_identity_lookup",
  "billedFeatureCode": "colombia_api_identity_lookup_premium"
}

Los montos son ilustrativos; los valores reales dependen de tu plan.

• SLA: Precio dinámico (facturación)
• Ruta premium directa: Cédula premium (/v2/co/cedula/premium) siempre usa tarificación premium.

Solicitud

Node.js

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

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)
print(r.json())

Respuesta

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"firstName": "Juan",
		"lastName": "Pérez",
		"fullName": "Juan Pérez",
		"status": "valid"
	},
	"signature": {
		"message": "Certified by Verifik.co",
		"dateTime": "January 16, 2024 3:44 PM"
	},
	"id": "AB123"
}

404

{
	"message": "Document not found",
	"code": "DOCUMENT_NOT_FOUND"
}

401

{
	"message": "Authentication required",
	"code": "UNAUTHORIZED"
}