Skip to main content

Colombia — Guía de documentos de identidad

Usa esta página cuando no estés seguro de qué tipo de documento tiene tu usuario o qué endpoint de Verifik debes llamar. Cada documento colombiano tiene un emisor distinto y una ruta de API diferente.

Tabla de decisión rápida​

Si la persona tiene…Nombre comúnEndpoint VerifikCampos requeridosLongitud típicaLo que acepta esta API
CCCédula de CiudadaníaGET/POST /v2/co/ceduladocumentType=CC, documentNumber3–10 dígitos (hoy común: 8 o 10 NUIP)5–10 dígitos
PPT (nombres / datos civiles)Permiso de Protección TemporalGET/POST /v2/co/ceduladocumentType=PPT, documentNumberHasta 7 dígitos (algunos sistemas rellenan a 15)5–10 dígitos en esta ruta
PPT (estado migratorio)Mismo permiso, Migración ColombiaGET/POST /v2/co/foreigner-id/pptdocumentNumber, expeditionDateHasta 7 dígitosTexto obligatorio + fecha DD/MM/YYYY
CECédula de ExtranjeríaGET/POST /v2/co/foreigner-id/cedocumentNumber, expeditionDateNormalmente 6–7 dígitosTexto obligatorio + fecha DD/MM/YYYY
PEPPermiso Especial de PermanenciaGET/POST /v2/co/foreigner-id/pepdocumentNumber, expeditionDate15 dígitos (fijo)Texto obligatorio + fecha DD/MM/YYYY

Cómo ingresar el número​

  • Envía solo dígitos — sin puntos, espacios ni guiones (Verifik elimina caracteres no numéricos).
  • No rellenes con ceros a la izquierda salvo que así figure en el documento físico o en tu sistema origen.
  • Si recibes 409 de validación, revisa la longitud en /v2/co/cedula (5–10) o una expeditionDate faltante o incorrecta en rutas foreigner-id.

Tipos de documento explicados​

CC — Cédula de Ciudadanía​

Para personas ciudadanas colombianas. El número las identifica en la Registraduría.

  • Cédulas antiguas (antes de ~2004): suelen tener 6–8 dígitos.
  • NUIP actual (desde ~2004): 10 dígitos, normalmente desde 1.000.000.000.
  • Cédulas históricas muy antiguas pueden tener 3 dígitos; la ruta /v2/co/cedula de Verifik exige mínimo 5 dígitos. Si solo tienes un número histórico más corto, contacta a soporte Verifik.

Endpoint: Ciudadano colombiano — documentType=CC.

CE — Cédula de Extranjería​

Para extranjeros con residencia legal en Colombia. Lo expide Migración Colombia, no el flujo de cédula de la Registraduría.

  • Los números suelen tener 6 o 7 dígitos (longitud variable).
  • Debes enviar la fecha de expedición en formato DD/MM/YYYY.

Endpoint: Colombia CE — no uses /v2/co/cedula.

PPT — Permiso de Protección Temporal​

Para nacionales venezolanos bajo el régimen de protección temporal en Colombia.

  • El número del permiso suele tener hasta 7 dígitos. Algunos portales (SENA, nómina, etc.) lo muestran rellenado con ceros hasta 15 caracteres — usa el formato que ya maneja tu integración.
  • Dos endpoints:
    • Consulta de nombre / identidad: /v2/co/cedula con documentType=PPT (validación 5–10 dígitos).
    • Estado migratorio (VIGENTE, vencimiento, etc.): /v2/co/foreigner-id/ppt con expeditionDate.

Endpoints: Ciudadano colombiano (PPT nombres) · PPT Migración.

PEP — Permiso Especial de Permanencia​

Para nacionales venezolanos con este permiso migratorio (distinto de “persona expuesta políticamente” en AML).

  • El número tiene siempre 15 dígitos.
  • Requiere expeditionDate en DD/MM/YYYY.

Endpoint: Colombia PEP (migración).

Distinción importante de nombres​

TérminoSignificadoProducto Verifik
PEP (documento)Permiso Especial de Permanencia — permiso migratorio/v2/co/foreigner-id/pep
Personas expuestas políticamente (PEP)Cumplimiento AML/v2/co/politically-exposed-persons (CC o NIT) — ver PEP colombiano (AML)

No envíes un PEP migratorio al endpoint AML de personas expuestas políticamente, ni al revés.

Preguntas frecuentes​

¿Debo usar CC o CE?

CC si la persona es ciudadana colombiana (Cédula de Ciudadanía). CE si es extranjero residente (Cédula de Extranjería). Usan fuentes gubernamentales y endpoints de Verifik distintos.

¿Qué endpoint PPT debo usar?

Usa /v2/co/cedula con documentType=PPT cuando necesites datos de identidad/nombre similares a una cédula. Usa /v2/co/foreigner-id/ppt cuando necesites el estado migratorio ante Migración Colombia — debes incluir expeditionDate.

¿Por qué mi CC falla con 409?

En /v2/co/cedula, documentNumber debe tener 5–10 dígitos tras la normalización. Números más cortos o formatos que dejen muy pocos dígitos se rechazan antes de consultar la fuente oficial.

Páginas relacionadas​