🇵🇪 Perú - Cédula de Extranjero

El servicio de Verificación de Identidad Peruano te permite verificar la identidad de un individuo en Perú por su número de cédula de extranjero. El servicio devuelve el nombre completo y otra información relacionada del individuo, incluyendo estado migratorio, nacionalidad, vencimiento de residencia y detalles de la cédula de extranjero, junto con una firma para certificar la autenticidad de la respuesta.

Este servicio es útil para verificar residentes extranjeros en Perú y acceder a su estado migratorio y validez de documentos.

Endpoint

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

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description	Example
documentNumber	string	Sí	Número de documento de la persona a consultar.	005015372
dateOfBirth	string	Sí	La fecha de nacimiento del propietario del documento.	16/08/1993

Solicitud

JavaScript

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/pe/foreigner-id/ce',
  params: {
    documentNumber: '005015372',
    dateOfBirth: '16/08/1993'
  },
  headers: { 
    'Authorization': 'Bearer <token>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
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();
}
?>

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/pe/foreigner-id/ce?documentNumber=005015372&dateOfBirth=16/08/1993")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

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()

Respuesta

200

{
  "data": {
    "arrayName": [
      "CORDERO",
      "SANCHEZ",
      "ANA",
      "RENE"
    ],
    "dateOfBirth": "16/08/1993",
    "documentNumber": "005015372",
    "firstName": "ANA RENE",
    "foreignerIdExpiration": "12/08/2025",
    "foreignerIdLastIssuance": "12/08/2021",
    "fullName": "ANA RENE CORDERO SANCHEZ",
    "immigrationStatus": "HUMANITARIA",
    "lastName": "CORDERO CAMPERO",
    "nationality": "VENEZOLANA",
    "residenceExpiration": "26/02/2025"
  },
  "signature": {
    "dateTime": "November 6, 2024 3:22 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "K0MMA"
}

404

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

409 - Falta número de documento

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

409 - Formato de fecha inválido

{
  "code": "MissingParameter",
  "message": "dateOfBirth format required: DD/MM/YYYY\n"
}

Características

• Verificación de Cédula de Extranjero: Verificar documentos de identidad de extranjeros en Perú
• Verificación de Estado Migratorio: Acceder al estado migratorio actual (ej. HUMANITARIA)
• Información de Nacionalidad: Obtener detalles de nacionalidad del residente extranjero
• Validez de Documento: Verificar vencimiento de cédula de extranjero y fechas de última emisión
• Estado de Residencia: Verificar fechas de vencimiento de residencia
• Información Personal: Acceder a nombre completo, primer nombre, apellido y fecha de nacimiento
• Validación de Número de Documento: Verificar números de documentos de extranjeros
• Validación de Formato de Fecha: Asegurar formato correcto de fecha de nacimiento (DD/MM/YYYY)
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Datos en Tiempo Real: Acceder a información de extranjeros actual y actualizada
• Manejo Completo de Errores: Respuestas de error detalladas para varios escenarios
• Integración con Inmigración Peruana: Acceso directo a base de datos oficial de inmigración peruana
• Gestión de Documentos de Extranjeros: Seguimiento completo del ciclo de vida de cédula de extranjero
• Cumplimiento de Residencia: Monitorear estado de residencia y fechas de vencimiento