Consulta - Extranjeros

Como indica su nombre, la validación de datos de extranjeros es parte fundamental de VerificaId — esa es la razón por la que existe VerificaID para que puedas reducir el riesgo en tus operaciones. En esta página, profundizaremos el cómo realizar validaciones de identidad de forma programática.

El modelo Extranjero

El modelo "extranjero" contiene información publicamente disponible sobre una extranjeros, como su nombre y apellidos. Es importante saber que el modelo identidad solamente contendrá información de personas mayores de edad.

Propiedades

  • Name
    numero_documento
    Type
    string
    Description

    Número de documento de identidad del extranjero.

  • Name
    calidad
    Type
    string
    Description

    La condición de calidad migratoria.

  • Name
    nombres
    Type
    string
    Description

    Tal y como se indica, los nombres completos de la persona.

  • Name
    apellido_paterno
    Type
    string
    Description

    El apellido parterno de la persona.

  • Name
    apellido_materno
    Type
    string
    Description

    El apellido materno de la persona.

  • Name
    fecha_nacimiento
    Type
    string
    Description

    Fecha de nacimiento de la persona.

  • Name
    fecha_expiracion_residencia
    Type
    string
    Description

    Fecha de expiración de la residencia.

  • Name
    fecha_expiracion_carnet
    Type
    string
    Description

    Fecha de expiración del Carnet.

  • Name
    fecha_ultima_emision_carnet
    Type
    string
    Description

    Última fecha de expiración del Carnet.


POST/v2/consulta/extranjeros

Validar datos Extranjeros

Este endpoint te permite validar datos de un extranjero consultando su número de documento.

Atributos requeridos

  • Name
    document_number
    Type
    string
    Description

    Número de documento, Carnet de Extranjería, a validar

  • Name
    birthdate
    Type
    string
    Description

    Fecha de nacimiento del titular del documento a validar

Request

POST
/v2/consulta/extranjeros
curl https://api.verifica.id/v2/consulta/extranjeros \
  -H "Authorization: Bearer {TU-API-KEY}" \
  -d document_number=003278330
  -d birthdate=1990-01-31

Response

{
"type": "result",
"status": 200,
"message": "Se ha validado la información correctamente.",
  "data": {
    "numero_de_documento": "012093887",
    "calidad_migratoria": "ESPECIAL",
    "nombres": "MIGUEL ADRIANO",
    "nacionalidad": "VENEZOLANA",
    "apellido_paterno": "CUBAS",
    "apellido_materno": "QUEVEDO",
    "fecha_nacimiento": "1990-01-31",
    "fecha_expiracion_residencia": "2026-01-30",
    "fecha_expiracion_carnet": "2026-01-24",
    "fecha_ultima_emision_carnet": "2023-02-02"
  }
}