🇵🇪 Peru — Cédula de estrangeiro (CE)

O serviço de verificação de identidade peruano para estrangeiros permite verificar a identidade de uma pessoa no Peru pelo número da cédula de estrangeiro. O serviço retorna o nome completo e outras informações relacionadas, incluindo status migratório, nacionalidade, expiração da residência e detalhes da cédula de estrangeiro, junto com uma assinatura para certificar a autenticidade da resposta.

Este serviço é útil para verificar residentes estrangeiros no Peru e acessar seu status migratório e a validade dos documentos.

Endpoint

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

Cabeçalhos

Nome	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição	Exemplo
documentNumber	string	Sim	Número do documento da pessoa a ser consultada.	005015372
dateOfBirth	string	Sim	Data de nascimento do titular do documento.	16/08/1993

Requisição

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

Resposta

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 - documentNumber ausente

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

409 - Formato de dateOfBirth inválido

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

Recursos

• Verificação de cédula de estrangeiro: verifica documentos de identidade de estrangeiros no Peru.
• Verificação de status migratório: acessa o status migratório atual (ex.: HUMANITARIA).
• Informações de nacionalidade: obtém detalhes de nacionalidade do residente estrangeiro.
• Validade do documento: verifica datas de expiração e última emissão da cédula de estrangeiro.
• Status de residência: verifica datas de expiração da residência.
• Informações pessoais: acessa nome completo, primeiro nome, sobrenome e data de nascimento.
• Validação do número do documento: verifica números de documentos de estrangeiros.
• Validação de formato de data: garante o formato correto de data de nascimento (DD/MM/AAAA).
• Múltiplas linguagens de programação: suporte para JavaScript, Python, PHP e Swift.
• Dados em tempo real: acesso a informações atualizadas de estrangeiros.
• Tratamento de erros abrangente: respostas de erro detalhadas para diversos cenários.
• Integração com a imigração peruana: acesso direto ao banco oficial de imigração do Peru.
• Gestão de documento de estrangeiro: rastreamento completo do ciclo de vida da cédula de estrangeiro.
• Conformidade de residência: monitora status e datas de expiração da residência.