Saltar al contenido principal
POST
Verifica la situación migratoria y la identidad de una persona extranjera con los registros gubernamentales de Migración Colombia (cédula de extranjería). Didit ofrece este servicio a través de POST /v3/database-validation/, para que puedas verificar los datos enviados en la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: —
  • País: Colombia
  • ID del servicio: col_migracion
  • Dominio de datos: Identidad
  • Categoría: ResidencePermit

Entradas

  • Entradas obligatorias: personal_number, date_of_birth, nationality
  • Entradas opcionales: first_name, last_name, vendor_data
  • Consentimiento: No es obligatorio
  • Disponibilidad en flujos: Disponible en flujos de verificación (workflows)
  • Cobertura: —
  • Precio: $1.20 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"COL"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo: COL
string
predeterminado:"col_migracion"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: col_migracion
string
predeterminado:"111111"
requerido
Número de identidad personal propio de cada país.Ejemplo: 111111
string
predeterminado:"1990-01-01"
requerido
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
string
predeterminado:"MEX"
requerido
Valor de nationality que exige este servicio de base de datos.Ejemplo: MEX
string
Nombre de pila que se va a validar.Ejemplo: John
string
Apellido que se va a validar.Ejemplo: Doe
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • Cédula colombiana (de 6 a 10 dígitos)
  • personal_number solo debe contener dígitos; elimina los espacios, guiones y signos de puntuación antes de enviar la solicitud.
  • personal_number debe tener entre 6 y 10 caracteres.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para col_migracion documenta actualmente esta estructura normalizada:
  • first_name
  • identification_number
  • last_name

Precios y SLA

Las consultas de situación de personas extranjeras de Colombia - Migración Colombia solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $1.20 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando el registro no está disponible, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 habitual < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026