Colombia - CE

La API de Verificación de Identidad de Verifik te ayuda a autenticar extranjeros en Colombia usando la Cédula de Extranjería (CE), el documento de identificación oficial para extranjeros residentes en Colombia. 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 verificar la identidad y el estado de residencia de extranjeros en Colombia, como para empleo, servicios financieros o cumplimiento legal.

¿Qué valida esta API?

Nuestra API se conecta directamente con registros oficiales de Migración Colombia para validar:

• Nombre Completo y Número de Documento: Soporta documentos de Cédula de Extranjería (CE).
• Información del Documento: Retorna número de documento, tipo, fecha de expedición y fecha de vencimiento.
• Coincidencia de Identidad: Verifica que la información personal coincida con el número de documento CE.
• Estado del Documento: Verifica el estado del documento (activo, vencido, etc.).

Al verificar estos detalles, puedes tener la certeza de que el extranjero con el que tratas tiene documentación de residencia válida, reduciendo significativamente el riesgo de fraude y asegurando el cumplimiento con las regulaciones colombianas.

Referencia de API

Endpoint

GET https://api.verifik.co/v2/co/foreigner-id/ce

Encabezados

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentNumber	string	Sí	Número de documento de la persona a consultar, sin espacios o puntos.
expeditionDate	string	Sí	Fecha de expedición del documento. Formato válido: DD/MM/YYYY.

Solicitud

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/foreigner-id/ce',
  params: {
    documentNumber: '123456789',
    expeditionDate: '10/10/2024'
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer <tu_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer <tu_token>'
}
conn.request("GET", "/v2/co/foreigner-id/ce?documentNumber=123456789&expeditionDate=10/10/2022", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

import Foundation

let url = URL(string: "https://api.verifik.co/v2/co/foreigner-id/ce?documentNumber=123456789&expeditionDate=10%2F10%2F2022")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <tu_token>", forHTTPHeaderField: "Authorization")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/foreigner-id/ce?documentNumber=123456789&expeditionDate=10/10/2022');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Accept' => 'application/json',
  'Authorization' => 'Bearer <tu_token>'
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

Respuesta

200

{
  "data": {
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "documentNumber": "123456789",
    "documentType": "CE",
    "expirationDate": "07/03/2017",
    "firstName": "MATEO",
    "fullName": "MATEO VERIFIK",
    "lastName": "VERIFIK",
    "status": "VENCIDO"
  },
  "signature": {
    "dateTime": "August 22, 2023 5:44 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "har4z"
}

404

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

409

{
    "code": "MissingParameter",
    "message": "missing expeditionDate\n. missing documentNumber\n"
}

---

Casos de Uso Comunes

• Verificación de Residente Extranjero: Valida el estado de residencia de extranjeros en Colombia para propósitos de empleo.
• Servicios Financieros: Verifica la identidad de extranjeros para aplicaciones bancarias y de servicios financieros.
• Cumplimiento Legal: Asegura el cumplimiento con las regulaciones colombianas para residentes extranjeros.
• Autenticación de Documentos: Autentica documentos de Cédula de Extranjería para propósitos oficiales.
• Verificación de Identidad: Simplifica los procesos de verificación de identidad para nacionales extranjeros.

Fuentes Oficiales y Confiabilidad

Nos conectamos directamente con fuentes oficiales de Migración 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.

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 verificación de identidad en tiempo real.
• Datos Confiables: Confía en datos obtenidos directamente de registros oficiales de Migración Colombia.
• 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.

Notas Importantes

• La Cédula de Extranjería (CE) es emitida por Migración Colombia para extranjeros residentes en el país. Para otros tipos de documentos, por favor consulta nuestros servicios de validación alternativos.
• El uso de este servicio está restringido a entidades autorizadas o permiso directo del usuario final. Los datos proporcionados están sujetos a las leyes de privacidad colombianas y deben manejarse de manera responsable.
• Siempre verifica con la cédula física CE para confirmar la información recuperada.

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, Argentina, Brasil y más allá.