🇻🇪 Venezuela - Cédula de extranjero (CEVE)

La API de Verificación de Identidad de Verifik te permite autenticar a personas extranjeras en Venezuela usando datos oficiales. Está pensada para agilizar el KYC, reducir fraude y apoyar el cumplimiento normativo.

¿Qué valida esta API?

Nuestra API se conecta con registros oficiales para validar:

• Nombre completo y número de documento: identificación de extranjeros (CEVE—Cédula de Identidad de Extranjero).
• Coincidencia de identidad: los nombres devueltos coinciden con el documento en archivo.
• Tipo de documento: la respuesta incluye documentType: "CEVE" en esta ruta.

Referencia de API

Endpoint

https://api.verifik.co/v2/ve/foreigner-id

Usa este endpoint para extranjeros con cédula CEVE. Pasa el número como documentNumber; el servicio aplica CEVE y devuelve campos de identidad estructurados. Para ciudadanos venezolanos (cédula nacional CCVE), usa GET /v2/ve/cedula.

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentNumber	string	Sí	Número de cédula CEVE. Se eliminan puntos y espacios. No envíes documentType: esta ruta siempre usa CEVE.

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/ve/foreigner-id", {
  params: { documentNumber: "10000001" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <tu_token>"
}

conn.request("GET", "/v2/ve/foreigner-id?documentNumber=10000001", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/ve/foreigner-id?documentNumber=10000001', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <tu_token>',
  ],
]);

echo $response->getBody();

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <tu_token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/ve/foreigner-id?documentNumber=10000001")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Respuesta

200

{
  "data": {
    "documentType": "CEVE",
    "documentNumber": "10000001",
    "fullName": "MATEO VENEZUELA VERIFIK",
    "lastName": "MATEO",
    "firstName": "VENEZUELA VERIFIK",
    "arrayName": [
      "MATEO",
      "VENEZUELA",
      "VERIFIK"
    ]
  },
  "signature": {
    "dateTime": "March 13, 2024 2:01 AM",
    "message": "Certified by Verifik.co"
  },
  "id": "7VWXP"
}

401

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

403

{
  "message": "Access forbidden",
  "code": "FORBIDDEN"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing documentNumber"
}

409 (fuera de servicio)

{
  "code": "Endpoint_out_of_service",
  "message": "Endpoint_out_of_service"
}

Notas

• documentNumber es obligatorio. Se eliminan puntos y espacios. No envíes documentType.
• Esta ruta es solo para documentos CEVE; la nacional CCVE usa /v2/ve/cedula.
• La respuesta incluye campos de nombre (arrayName, firstName, lastName, fullName).
• Sandbox: 10000001–10000010 son fijos. 90040401 responde 404. 90050001 responde 500.
• Si el servicio no está disponible temporalmente, la API responde 409 con code: "Endpoint_out_of_service".

---

Casos de uso comunes

• Verificación de residentes extranjeros: validar identidad para empleo o servicios.
• Servicios financieros: onboarding con cédula de extranjero.
• Cumplimiento: procesos que requieren verificar CEVE.

Confiabilidad

Cada consulta se maneja con estricto cumplimiento de estándares de seguridad y regulatorios.

Beneficios clave

• KYC más rápido: respuestas estructuradas listas para integrar.
• Datos confiables: coherencia con registros oficiales cuando el documento existe.

Cumplimiento y seguridad

Verifik utiliza HTTPS (TLS) y buenas prácticas de privacidad para proteger las consultas.

Sobre Verifik

Verifik conecta empresas con fuentes oficiales de datos en Latinoamérica para automatizar KYC, KYB y validaciones asociadas.