Consultar cédula Venezuela con API (2026): CCVE y CEVE, 10 números de prueba y ejemplo

Respuesta corta: Para consultar una cédula de Venezuela con API, envía un GET a https://api.verifik.co/v2/ve/cedula con el parámetro documentNumber. Verifik devuelve el nombre completo, los nombres, los apellidos y el tipo de documento (CCVE) y, cuando están disponibles, fecha de nacimiento, género y estado civil. Cada consulta se paga con créditos de smartCHECK, desde $49 al mes.

Si validas clientes, empleados o repartidores venezolanos, el número de cédula por sí solo no te dice si pertenece a la persona que tienes enfrente. Con la API de ciudadano venezolano de Verifik lo compruebas con 1 llamada: el endpoint GET /v2/ve/cedula recibe el número de cédula nacional (CCVE) y devuelve los nombres registrados para que los compares con lo que declaró tu usuario. Para residentes extranjeros con cédula CEVE existe un segundo endpoint, GET /v2/ve/foreigner-id, con la misma forma de uso.

Esta guía es técnica: verás los parámetros, los 10 números de prueba del sandbox, un ejemplo de solicitud y respuesta tomado de la documentación, cómo manejar cada código de error y cuánto cuesta.

Qué devuelve la consulta de cédula de Venezuela por API

Según la documentación, la API se conecta con registros oficiales del gobierno y responde con un objeto data que incluye:

• Documento: documentType (siempre CCVE en esta ruta) y documentNumber.
• Nombres: fullName, firstName, lastName y arrayName, un arreglo con cada nombre y apellido por separado.
• Datos opcionales: birthDate (formato YYYY-MM-DD), gender y maritalStatus. Solo aparecen cuando están disponibles, así que tu código no debe darlos por hechos.
• Firma: un objeto signature con fecha y hora y el mensaje “Certified by Verifik.co”, más un id único de la consulta.

En Venezuela, los trámites de identificación de ciudadanos y extranjeros están a cargo del SAIME (Servicio Administrativo de Identificación, Migración y Extranjería). La documentación de Verifik habla de “datos oficiales del gobierno” y no detalla la entidad de origen, así que si tu proceso exige una fuente concreta, confírmalo con el equipo de Verifik antes de integrar.

CCVE o CEVE: qué endpoint usar

Verifik separa los dos tipos de cédula venezolana en rutas distintas. Ninguna recibe documentType: la ruta ya define el tipo.

• Venezolanos (CCVE, cédula de identidad): GET https://api.verifik.co/v2/ve/cedula. Devuelve nombres y, cuando existen, fecha de nacimiento, género y estado civil.
• Extranjeros residentes (CEVE, cédula de identidad de extranjero): GET https://api.verifik.co/v2/ve/foreigner-id. Devuelve los campos de nombre y documentType: "CEVE". Más detalles en la documentación de la cédula de extranjero.

La regla para tu formulario es simple: pregunta primero si la persona es venezolana o extranjera residente. Si es venezolana llamas a /v2/ve/cedula; si es extranjera, a /v2/ve/foreigner-id.

Cómo consultar una cédula venezolana con la API de Verifik

Necesitas tu token de Verifik y 1 parámetro obligatorio:

• documentNumber: el número de cédula. La API elimina puntos y espacios, así que 10.000.001 y 10000001 se tratan igual.

Este es el ejemplo en Python de la documentación:

import os, requests

url = "https://api.verifik.co/v2/ve/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "10000001"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Y esta es la estructura de la respuesta 200 con campos opcionales que muestra la documentación (enmascaramos los datos personales):

{
  "data": {
    "arrayName": [
      "NOMBRE1",
      "NOMBRE2",
      "APELLIDO1",
      "APELLIDO2"
    ],
    "birthDate": "1998-03-01",
    "documentNumber": "********",
    "documentType": "CCVE",
    "firstName": "NOMBRE1 NOMBRE2",
    "fullName": "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2",
    "gender": "FEMENINO",
    "lastName": "APELLIDO1 APELLIDO2"
  },
  "signature": {
    "dateTime": "November 13, 2025 8:12 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "GGLIK"
}

¿Quieres probarlo con tus propios casos? Crea tu cuenta gratis en Verifik y haz tu primera consulta en el sandbox.

Sandbox y códigos de error

Antes de salir a producción puedes probar todos los caminos con números fijos del sandbox:

• 10 números estables: del 10000001 al 10000010.
• 90040401: responde 404 {"code":"NotFound","message":"Record not found."}.
• 90050001: responde 500 {"code":"InternalServerError","message":"Server error."}.

Estos son los demás errores documentados y qué hacer con cada uno:

1. 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido. Revisa el encabezado Authorization: Bearer.
2. 403 FORBIDDEN (“Access forbidden”): tu cuenta no tiene acceso a la ruta. Consulta con Verifik para habilitarla.
3. 404 NotFound (“Record not found.”): no hay registro para ese número. Pide al usuario que confirme la cédula o envía el caso a revisión manual; no lo rechaces de forma automática.
4. 409 MissingParameter (“missing documentNumber”): no enviaste el número.
5. 409 Endpoint_out_of_service: el servicio no está disponible temporalmente. Reintenta más tarde o deja el onboarding en espera en lugar de bloquear al usuario.
6. 500 InternalServerError: error del servidor. Reintenta con espera progresiva.

Reglas de negocio para tu onboarding

1. Coincidencia de nombre: compara fullName con el nombre que escribió el usuario. Usa arrayName para tolerar diferencias de orden, segundos nombres omitidos o tildes.
2. Edad mínima: si llega birthDate, calcula la edad; si no llega, pide otra prueba en lugar de asumirla.
3. Tipo de documento: guarda documentType (CCVE o CEVE) junto al expediente para saber qué ruta se usó.
4. Evidencia: conserva el id y la signature de cada respuesta.

Para un proceso KYC más completo, revisa también cómo Verifik aborda la verificación de cédulas venezolanas para empresas, la cédula de extranjería venezolana, la cédula de ciudadanía colombiana (útil si atiendes usuarios en ambos países), la cédula de extranjería en Colombia y qué es una solución eKYC.

Datos personales: qué dicen los términos de Verifik

Nombre, fecha de nacimiento y estado civil son datos personales. Los términos y condiciones de smartCHECK indican que, cuando consultas información de un tercero, tu empresa actúa como Controlador de los datos y Verifik como Procesador. En ese caso debes:

• Recopilar, almacenar, usar, circular y eliminar los datos conforme a la ley aplicable.
• Solicitar la autorización de cada titular y conservar prueba de ella.
• Informar a Verifik de actualizaciones, rectificaciones, revocatorias de la autorización y solicitudes de eliminación.

Verifik puede terminar el servicio si no se cumplen estas obligaciones. Este artículo no es asesoría legal: valida tu caso de uso con tu equipo jurídico.

Cuánto cuesta consultar cédulas de Venezuela con Verifik

Cada consulta se descuenta de los créditos de tu plan de smartCHECK. Según la página de precios de smartCHECK:

• Starter: $49 al mes, o $490 al año recibiendo $588 en créditos.
• Basic: $129 al mes, o $1.290 al año recibiendo $1.548 en créditos.
• Plus: $299 al mes, o $2.990 al año recibiendo $3.588 en créditos.
• Business: $649 al mes, o $6.490 al año recibiendo $7.788 en créditos.

Los planes anuales incluyen 2 meses gratis, y smartCHECK reúne más de 90 API de más de 15 países. La página no publica un precio por consulta para este endpoint; si necesitas el costo exacto por llamada, pídelo al agendar una sesión.

Respuestas rápidas

¿Qué necesito para consultar una cédula de Venezuela por API? Un token de Verifik y el número de cédula. Lo envías como documentNumber a GET /v2/ve/cedula.

¿Qué endpoint uso para la cédula de un extranjero residente? GET /v2/ve/foreigner-id, que trabaja con cédulas CEVE. La cédula de venezolanos (CCVE) va por /v2/ve/cedula.

¿La API devuelve la fecha de nacimiento? Cuando está disponible, sí: birthDate llega en formato YYYY-MM-DD, junto con gender y maritalStatus. No siempre vienen.

¿Qué números puedo usar para probar? En sandbox, del 10000001 al 10000010 son fijos; 90040401 devuelve 404 y 90050001 devuelve 500.

¿Qué significa el error 409 Endpoint_out_of_service? Que el servicio no está disponible temporalmente. Reintenta más tarde y no lo trates como una cédula inválida.

Empieza a consultar cédulas venezolanas hoy

Automatizar la consulta de cédulas te ahorra revisiones manuales y te deja una respuesta firmada por cada verificación. Revisa la documentación del endpoint y prueba los 10 números del sandbox.

¿Listo para empezar? Crea tu cuenta gratis en Verifik o agenda una demo para ver cómo integrar la validación de cédulas en tu onboarding.