🇵🇪 Perú - ID Completo

Esta llamada API realiza una verificación extendida de identidad para un ciudadano peruano usando su número de DNI (Documento Nacional de Identidad). Recupera información personal detallada: nombre completo, estado civil, fecha de nacimiento, desglose de dirección (provincia, área, distrito) y campos de identidad relacionados.

El header de Authorization es requerido para autenticación para acceder a esta información de forma segura.

¿Qué valida esta API?

Nuestra API se conecta directamente con registros oficiales peruanos para validar:

• Nombre completo y número de DNI: admite documentos Documento Nacional de Identidad (DNI).
• Coincidencia de identidad: confirma que el nombre proporcionado coincide con el número de DNI.
• Datos personales extendidos: devuelve estado civil, fecha de nacimiento, sexo, dirección, provincia, área y distrito.
• Componentes del nombre: devuelve firstName, lastName, paternalLastName, maternalLastName y arrayName.
• Información del documento: devuelve tipo y número de documento.

Algunos campos siempre están presentes en la respuesta pero actualmente devuelven la cadena not_available (no se omiten): photo, expeditionDate, expirationDate, ubigeoReniec y verificationDigit. La foto no se ofrece actualmente en este endpoint.

Endpoint

GET https://api.verifik.co/v3/pe/cedula/extra

Devuelve datos extendidos de DNI RENIEC para ciudadanos peruanos: nombre completo, estado civil, fecha de nacimiento, dirección (provincia, área, distrito) y campos de identidad relacionados. Envíe documentType=DNI y el documentNumber de 8 dígitos.

photo, expeditionDate, expirationDate, ubigeoReniec y verificationDigit están incluidos en la forma de la respuesta pero actualmente devuelven not_available.

Headers

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

Parámetros

Name	Type	Required	Description	Example
documentType	string	Sí	Tipo de documento. Valor permitido: DNI.	DNI
documentNumber	string	Sí	Número de DNI de 8 dígitos (sin espacios).	44868598

Solicitud

JavaScript

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 <tu_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

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)

Ruby

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

curl --location --request GET 'https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598' \
--header 'Authorization: Bearer <token>'

Respuesta

200

{
  "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"
}

404

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

409 - Faltan parámetros

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

409 - Tipo de documento inválido

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [DNI]"
}

Campos de respuesta

Campo	Valor típico	Notas
address, province, area, homeDistrict	Cadenas con datos	Desglose de dirección desde registros RENIEC.
arrayName, firstName, lastName, paternalLastName, maternalLastName, fullName	Cadenas con datos	Componentes del nombre.
civilStatus, dateOfBirth, sex	Cadenas con datos	Datos demográficos.
documentType, documentNumber	Cadenas con datos	Identificador DNI.
photo, expeditionDate, expirationDate, ubigeoReniec, verificationDigit	not_available	Presentes en la respuesta pero no poblados en el producto actual.

Características

• Verificación extendida de identidad: verificación integral de identidad para ciudadanos peruanos usando DNI
• Información personal detallada: nombre completo, componentes del nombre y arrayName
• Datos demográficos: estado civil, sexo, fecha de nacimiento e información de dirección (provincia, área, distrito)
• Detalles del documento: tipo y número de documento
• Campos no disponibles: photo, expeditionDate, expirationDate, ubigeoReniec y verificationDigit devuelven not_available en el producto actual
• Múltiples lenguajes de programación: soporte para JavaScript, Python, Ruby y cURL
• Datos en tiempo real: información de ciudadanos actual y actualizada
• Manejo completo de errores: respuestas de error detalladas para varios escenarios
• Integración con registro peruano: acceso directo a base de datos oficial de ciudadanos peruanos
• Autenticación segura: header de Authorization requerido para acceso seguro