Colombia — CE (Cédula de Extranjería)
Verifik valida registros de CE publicados por Migración Colombia para KYC, elegibilidad y cumplimiento.
Qué devuelve la API
- Estado (p. ej. VIGENTE) y fechas clave, incluidas expedición y vencimiento cuando la fuente las entrega
- Nombre estructurado y metadatos del documento CE
- Respuesta firmada; caché opcional
Referencia de API
Endpoint
GET https://api.verifik.co/v2/co/foreigner-id/ce
La misma integración está disponible como POST con cuerpo JSON con los mismos campos. En GET usa parámetros de query como abajo.
Encabezados
| Nombre | Valor |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parámetros
| nombre | tipo | requerido | descripción |
|---|---|---|---|
documentNumber | string | sí | Número de CE sin espacios ni puntuación. |
expeditionDate | string | sí | Fecha de expedición en DD/MM/AAAA (p. ej. 15/06/2020). |
Solicitud
- JavaScript
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/foreigner-id/ce", {
params: {
documentNumber: "987654321",
expeditionDate: "15/06/2020",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/foreigner-id/ce"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "987654321", "expeditionDate": "15/06/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
Respuesta
- 200
- 404
- 409
{
"data": {
"documentNumber": "987654321",
"documentType": "CE",
"expirationDate": "15/06/2030",
"firstName": "MARIA",
"fullName": "MARIA EJEMPLO PEREZ",
"lastName": "EJEMPLO PEREZ",
"status": "VIGENTE"
},
"signature": {
"dateTime": "April 20, 2026 10:00 AM",
"message": "Certified by Verifik.co"
},
"id": "CE01A"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "expeditionDate must be a valid date in DD/MM/YYYY format"
}
Características
- Consulta oficial de CE ante Migración Colombia
- Vigencia y fechas cuando la fuente las devuelve
Casos de uso
- Onboarding de residentes extranjeros con CE colombiana
- Banca, empleo y cumplimiento que requieran confirmar estado migratorio
Notas
expeditionDatedebe estar enDD/MM/AAAA; formatos incorrectos suelen devolver 409.GETyPOSTcomparten el mismo manejador; usaPOSTsi prefieres JSON en el cuerpo.- Cambios en el portal o indisponibilidad pueden producir 404 / 500.