🇵🇪 Peru — DNI (dados estendidos)
A API de verificação de identidade da Verifik permite realizar verificação de identidade estendida para cidadãos peruanos usando o número do DNI (Documento Nacional de Identidad). Foi projetada para automatizar seus processos de KYC (Know Your Customer), prevenir fraudes e garantir o cumprimento de todos os requisitos regulatórios sem esforço.
Construímos esta integração para empresas que precisam de uma forma rápida, segura e automatizada de acessar informações pessoais estendidas, incluindo nome completo, estado civil, data de nascimento, detalhamento do endereço (província, área, distrito de residência) e outros campos de identidade relacionados.
O cabeçalho Authorization é obrigatório para autenticar o acesso a essas informações com segurança.
O que esta API valida?
Nossa API conecta-se diretamente aos registros oficiais peruanos para validar:
- Nome completo e número do DNI: suporta documentos do tipo Documento Nacional de Identidad (DNI).
- Correspondência de identidade: confirma que o nome informado corresponde ao número do DNI.
- Dados pessoais estendidos: retorna estado civil, data de nascimento, sexo, endereço, província, área e distrito de residência.
- Componentes do nome: retorna
firstName,lastName,paternalLastName,maternalLastNameearrayName. - Informações do documento: retorna tipo e número do documento.
Alguns campos estão sempre presentes na resposta, mas atualmente retornam a string not_available (não são omitidos): photo, expeditionDate, expirationDate, ubigeoReniec e verificationDigit. A foto não é oferecida atualmente neste endpoint.
Ao validar esses elementos, você pode confiar que a pessoa com quem está negociando é real e possui um documento válido, reduzindo significativamente os riscos de personificação e fraude.
Endpoint
GET https://api.verifik.co/v3/pe/cedula/extra
Retorna dados DNI RENIEC estendidos para cidadãos peruanos: nome completo, estado civil, data de nascimento, endereço (província, área, distrito de residência) e outros campos de identidade relacionados. Envie documentType=DNI e o documentNumber de 8 dígitos.
photo, expeditionDate, expirationDate, ubigeoReniec e verificationDigit estão incluídos na estrutura da resposta, mas atualmente retornam not_available.
Cabeçalhos (Headers)
| Nome | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Parâmetros
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
documentType | string | Sim | Tipo de documento. Valor permitido: DNI. | DNI |
documentNumber | string | Sim | Número de DNI de 8 dígitos (sem espaços). | 44868598 |
Requisição (Request)
- JavaScript
- Python
- Ruby
- cURL
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.verifik.co/v3/pe/cedula/extra',
params: {
documentType: 'DNI',
documentNumber: '44868598'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <seu_token>'
}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
import requests
url = "https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598"
payload = {}
headers = {
'Authorization': 'Bearer <token>'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer <token>"
response = https.request(request)
puts response.read_body
curl --location --request GET 'https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598' \
--header 'Authorization: Bearer <token>'
Resposta (Response)
- 200
- 404
- 409 - Parâmetros ausentes
- 409 - documentType inválido
{
"data": {
"address": "SAN MARTIN-SAN MARTIN-SHAPAJA",
"arrayName": [
"JORGE",
"EDUARDO",
"VARGAS",
"RAMIREZ"
],
"civilStatus": "SOLTERO",
"dateOfBirth": "03-04-1986",
"documentNumber": "44868598",
"documentType": "DNI",
"expeditionDate": "not_available",
"expirationDate": "not_available",
"firstName": "JORGE EDUARDO",
"fullName": "JORGE EDUARDO VARGAS RAMIREZ",
"lastName": "VARGAS RAMIREZ",
"maternalLastName": "RAMIREZ",
"paternalLastName": "VARGAS",
"photo": "not_available",
"sex": "M",
"ubigeoReniec": "not_available",
"verificationDigit": "not_available",
"province": "SAN MARTIN",
"area": "SAN MARTIN",
"homeDistrict": "SHAPAJA"
},
"signature": {
"dateTime": "October 5, 2026 7:00 PM",
"message": "Certified by Verifik.co"
},
"id": "G2ZOZ"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [DNI]"
}
Campos da resposta
| Campo | Valor típico | Notas |
|---|---|---|
address, province, area, homeDistrict | Strings preenchidas | Detalhamento do endereço dos registros RENIEC. |
arrayName, firstName, lastName, paternalLastName, maternalLastName, fullName | Strings preenchidas | Componentes do nome. |
civilStatus, dateOfBirth, sex | Strings preenchidas | Dados demográficos. |
documentType, documentNumber | Strings preenchidas | Identificador DNI. |
photo, expeditionDate, expirationDate, ubigeoReniec, verificationDigit | not_available | Presentes na resposta, mas não preenchidos no nível de produto atual. |
Casos de uso comuns
- Processos KYC avançados: realize verificação de identidade abrangente para reforçar conformidade e detecção de fraude.
- Serviços financeiros: verifique dados detalhados de identidade para aplicações bancárias e financeiras.
- Verificação de emprego: valide informações pessoais completas para processos de contratação.
- Conformidade e diligência: assegure conformidade com regulamentações peruanas que exigem dados estendidos de identidade.
- Detecção de fraude: utilize dados demográficos e de endereço estendidos para prevenção avançada de fraude.
Fontes oficiais e confiabilidade
Conectamos diretamente às fontes oficiais do governo peruano (RENIEC) para garantir que você receba informações verificadas e atualizadas. Cada consulta é tratada com estrita aderência a padrões de segurança e regulação.
Principais benefícios
- Conformidade automatizada: simplifique seus controles KYC para prevenir fraudes sem adicionar atrito para seus usuários.
- Acesso a dados estendidos: obtenha informações abrangentes de identidade, incluindo endereço, estado civil e dados demográficos.
- Resultados instantâneos: processe verificações em segundos, ideal para verificação de identidade em tempo real.
- Dados confiáveis: apoie-se em dados obtidos diretamente dos registros oficiais do RENIEC.
- Integração simples: conecte-se facilmente via nossa API REST ou utilize nossos SDKs compatíveis.
Conformidade e segurança
Priorizamos a segurança dos seus dados. A Verifik utiliza criptografia avançada (HTTPS / TLS 1.3) e padrões rigorosos de gerenciamento de privacidade para garantir a confidencialidade. Nosso serviço é monitorado 24/7 quanto à disponibilidade e oferece controles de acesso baseados em funções para manter o acesso da sua equipe seguro.
Sobre a Verifik
A Verifik é uma plataforma líder em verificação de identidade, conformidade e prevenção de fraude em toda a América Latina. Nossas APIs automatizam processos de KYC, KYB, AML e validação biométrica, conectando empresas a fontes de dados oficiais na Colômbia, México, Peru, Chile, Uruguai, Argentina, Brasil e além.