---
title: Peru DNI Verification
slug: us-apis/peru-dni-verification
createdAt: 2024-04-29T09:41:41.422Z
---

# Overview and Purpose

## Overview

The **Peru DNI Verification API** enables businesses to verify the identity of Peruvian citizens using the **Documento Nacional de Identidad (DNI)**. It offers a fast, secure, and automated method to validate official identity details, making it ideal for KYC, onboarding, and regulatory compliance workflows.

The API confirms the authenticity of a DNI and retrieve associated personal information. By validating that the provided DNI matches the registered identity details, businesses can confidently verify users, employees, or customers while minimizing fraud and manual effort.

## Key Features and Functionalities

**DNI-Based Identity Verification**
Verifies Peruvian identities using the official Documento Nacional de Identidad (DNI).&#x20;

**Full Name Validation**
Allows user to check if full name provided matches the name registered against the DNI.

**KYC & Compliance Ready**
Designed to support regulatory and compliance requirements for customer, employee, or user verification in Peru.

**Easy Integration**
Simple API structure that can be quickly integrated into existing onboarding or verification systems.

# API Details

**API Overview:**

The Verification API validates an individual’s identity by retrieving and confirming official personal details. Based on the provided identifier, the API returns verified identity information, including full name, last name components, date of birth, gender, national identity number (DNI), address, and civil status.

**Authorization:**

Access to this API is granted via an Authorization Token, ensuring secure and authenticated access for authorized users.

## Sample cURL

:::CodeblockTabs
PreProduction

```json
postman request POST 'https://api-preproduction.signzy.app/api/v3/peru-dni-verification' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: <Auth-Token>' \
  --body '{"dni": ""}'
```

Production

```json
postman request POST 'https://api.signzy.app/api/v3/peru-dni-verification' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: <Auth-Token>' \
  --body '{"dni": ""}'
```
:::

## API Input

```json
{
    "dni": ""
}
```

## Request Body Parameters

| Parameter | Type   | Description                                                                   | Required/Optional |
| --------- | ------ | ----------------------------------------------------------------------------- | ----------------- |
| dni       | String | National identity number of the individual. **Must be exactly 8 characters.** | Required          |

## Response

:::CodeblockTabs
200

```json
{
    "result": {
        "address": "STRING",
        "civilStatus": "STRING",
        "dateOfBirth": "YYYY-MM-DD",
        "dni": "XXXXXXXX",
        "firstName": "STRING",
        "lastName": "STRING",
        "fullName": "STRING",
        "maternalLastName": "STRING",
        "paternalLastName": "STRING",
        "gender": "STRING",
        "ubigeoReniec": "STRING",
        "verificationDigit": "STRING"
    },
    "reason": "Request Successful",
    "code": "S001"
}
```
:::

## Response Body Parameters

| Parameter                | Description                                                              | Data Type |
| ------------------------ | ------------------------------------------------------------------------ | --------- |
| result                   | Contains the personal information returned after successful verification | Object    |
| result.address           | Registered address of the individual                                     | String    |
| result.civilStatus       | Civil/marital status of the individual                                   | String    |
| result.dateOfBirth       | Date of birth of the individual in yyyy-mm-dd format                     | String    |
| result.dni               | National identity number (DNI) of the individual                         | String    |
| result.firstName         | First name(s) of the individual                                          | String    |
| result.lastName          | Combined last name of the individual                                     | String    |
| result.fullName          | Full name of the individual                                              | String    |
| result.maternalLastName  | Maternal last name of the individual                                     | String    |
| result.paternalLastName  | Paternal last name of the individual                                     | String    |
| result.gender            | Gender of the individual (M / F)                                         | String    |
| result.ubigeoReniec      | Geographic location code issued by RENIEC                                | String    |
| result.verificationDigit | Verification digit associated with the DNI                               | String    |
| reason                   | Describes the outcome of the API request                                 | String    |
| code                     | API response code indicating request status (e.g., S001)                 | String    |

## Error Code and Response Mapping

:::CodeblockTabs
400 (Bad Request)

```json
{
    "result": {},
    "reason": "dni must be exactly 8 numeric digits",
    "code": "E001"
}
```

409(Upstream Down

```json
{
    "result": {},
    "reason": "Error in fetching data from Upstream",
    "code": "E401"
}
```
:::

| Field  | Type   | Description                                 |
| ------ | ------ | ------------------------------------------- |
| result | Object | Empty object returned                       |
| reason | string | Reason for the error                        |
| code   | string | Status code representing the error scenario |



:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::

