🪪 ID Status

The Peru Document ID Status report validates various identification documents from Peru and retrieves associated personal data from official government databases.

Overview

Peru Document ID Status provides comprehensive validation for three primary types of Peruvian identification documents. This report ensures accurate identity verification by accessing official databases maintained by Peruvian government institutions.

Supported Document Types

🆔 DNI (Documento Nacional de Identidad)

Purpose: Primary identification card for Peruvian citizens
Usage: Required for voting, banking, employment, and government services
Format: 8 digits
Coverage: All Peruvian citizens

🌍 Carne de Extranjería

Purpose: ID card for foreign residents in Peru
Usage: Identifies non-citizen residents with work/study/residence rights
Format: Variable alphanumeric
Coverage: Foreign residents with legal status

🛡️ PTP (Permiso Temporal de Permanencia)

Purpose: Temporary residency permit for Venezuelan migrants
Usage: Allows work, study, and health services access
Format: Variable alphanumeric
Coverage: Venezuelan nationals fleeing economic crisis

Input Requirements

Required Fields

Field	Type	Description	Example
`document_id`	string	Document identification number	`12345678`
`city_locode`	string	UN LOCODE of the city	`PE LIM`
`document_type`	string	Type of document to validate	`dni`, `foreigner_card`, `ptp`

Optional Fields

Field	Type	Description	Default
`full_name`	string	Expected full name for verification	`null`
`date_of_birth`	string	Expected date of birth (YYYY-MM-DD)	`null`

Official Data Sources

CECI (Sistema de Consultas Electrónicas de la Ciudadanía)

Authority: Registro Nacional de Identificación y Estado Civil (RENIEC)
Coverage: DNI validation and citizen data
Update Frequency: Real-time
Data Quality: Authoritative source for citizen information

JNE (Jurado Nacional de Elecciones)

Authority: National Elections Jury
Coverage: Electoral registry and citizen verification
Update Frequency: Regular updates during electoral periods
Data Quality: Official electoral and citizenship data

Superintendencia Nacional de Migraciones del Perú

Authority: National Migration Authority
Coverage: Foreign resident and temporary permit data
Update Frequency: Real-time
Data Quality: Official immigration and residency status

Response Schemas

DNI - Successful Validation

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "document_id_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "PASSED",
      "details": {
        "document_id": "12345678",
        "document_type": "dni",
        "full_name": "JUAN CARLOS RODRIGUEZ MARTINEZ",
        "date_of_birth": "1985-03-15",
        "place_of_birth": "LIMA, PERU",
        "gender": "M",
        "marital_status": "SOLTERO",
        "address": "AV. PRINCIPAL 123, LIMA",
        "validation": {
          "format_valid": true,
          "registry_found": true,
          "status": "ACTIVE"
        }
      }
    }
  }
}

Carne de Extranjería - Successful Validation

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "document_id_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "PASSED",
      "details": {
        "document_id": "CE123456789",
        "document_type": "foreigner_card",
        "full_name": "MARIA ELENA GONZALEZ SILVA",
        "nationality": "COLOMBIAN",
        "date_of_birth": "1990-07-22",
        "entry_date": "2018-01-15",
        "residence_status": "RESIDENT",
        "permit_expiry": "2025-01-15",
        "validation": {
          "format_valid": true,
          "registry_found": true,
          "status": "VALID"
        }
      }
    }
  }
}

PTP - Successful Validation

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "document_id_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "PASSED",
      "details": {
        "document_id": "PTP987654321",
        "document_type": "ptp",
        "full_name": "CARLOS ANTONIO MENDEZ TORRES",
        "nationality": "VENEZUELAN",
        "date_of_birth": "1988-11-10",
        "issue_date": "2020-03-01",
        "expiry_date": "2022-03-01",
        "permit_status": "EXPIRED",
        "renewal_eligible": true,
        "validation": {
          "format_valid": true,
          "registry_found": true,
          "status": "EXPIRED"
        }
      }
    }
  }
}

Document Not Found

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "document_id_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "INCOMPLETE",
      "details": {
        "document_id": "INVALID123",
        "document_type": "dni",
        "message": "No details found for the provided ID",
        "validation": {
          "format_valid": false,
          "registry_found": false,
          "errors": [
            "Document not found in official registry",
            "Invalid document format"
          ]
        }
      }
    }
  }
}

Document Format Validation

DNI Format Rules

Length: Exactly 8 digits
Pattern: Numeric only (00000000-99999999)
Check Digit: None required
Example: 12345678

Carne de Extranjería Format Rules

Length: Variable (typically 9-12 characters)
Pattern: Alphanumeric with prefix
Prefix: Usually starts with “CE”
Example: CE123456789

PTP Format Rules

Length: Variable (typically 10-15 characters)
Pattern: Alphanumeric with prefix
Prefix: Usually starts with “PTP”
Example: PTP987654321

Validation Process

Multi-Database Verification

Format Validation: Document follows Peru-specific format rules
Primary Database Lookup: Check main registry (CECI for DNI)
Secondary Database Verification: Cross-check with JNE or Migration
Data Consolidation: Merge information from multiple sources
Status Verification: Confirm current validity and status

Data Quality Assurance

Real-time Access: Direct connection to government databases
Cross-Validation: Multiple source verification for accuracy
Status Checking: Current validity and expiration verification
Error Handling: Comprehensive error reporting and resolution

API Integration Examples

DNI Validation Request

curl -X POST "https://api.emptor.io/v3/pe/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "12345678",
    "document_type": "dni",
    "city_locode": "PE LIM",
    "pipeline": {
      "name": "basic_id_check"
    }
  }'

Foreigner Card Validation Request

curl -X POST "https://api.emptor.io/v3/pe/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "CE123456789",
    "document_type": "foreigner_card",
    "city_locode": "PE LIM",
    "pipeline": {
      "name": "basic_id_check"
    }
  }'

PTP Validation Request

curl -X POST "https://api.emptor.io/v3/pe/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "PTP987654321",
    "document_type": "ptp",
    "city_locode": "PE LIM",
    "pipeline": {
      "name": "basic_id_check"
    }
  }'

Retrieve Report Details

curl -X GET "https://api.emptor.io/v3/pe/details/{person_id}/document_id_status" \
  -H "X-Api-Key: YOUR_API_KEY"

Common Validation Errors

Error Type	Description	Resolution
`INVALID_FORMAT`	Document doesn’t match Peru format	Verify document format for specific type
`INVALID_LENGTH`	Document length incorrect	Check digit/character count requirements
`NOT_FOUND_IN_REGISTRY`	Document not found in official database	Verify document exists and is issued
`EXPIRED_DOCUMENT`	Document has expired (PTP/Foreigner Card)	Check expiration date and renewal status
`REGISTRY_TIMEOUT`	Government database timeout	Retry after a few minutes
`UNSUPPORTED_DOCUMENT_TYPE`	Document type not supported	Use supported types: dni, foreigner_card, ptp

Document-Specific Features

DNI Comprehensive Data

Personal Information: Full name, birth date, place of birth
Civil Status: Marital status and family information
Address Information: Current registered address
Electoral Status: Voting eligibility and registration

Carne de Extranjería Migration Data

Residency Status: Current legal status in Peru
Entry Information: Date of entry and migration history
Permit Details: Expiration dates and renewal eligibility
Work Authorization: Employment permission status

PTP Temporary Status

Venezuelan Focus: Specialized for Venezuelan migration crisis
Temporary Nature: Limited duration permits with expiration
Service Access: Healthcare, education, and employment rights
Renewal Process: Eligibility for permit extensions

Use Cases and Applications

Primary Applications

Identity Verification: Comprehensive identity validation for all residents
Employment Screening: Verify work authorization and legal status
Financial Services: Account opening and KYC compliance
Government Services: Citizen and resident service verification
Healthcare Access: Patient identity and eligibility verification

Integration Workflows

Basic Identity Verification

Document ID Status → Name Check → Address Verification

Employment Screening

Document ID Status → Work Authorization Check → Background Verification

Financial KYC

Document ID Status → Name Check → Address Verification → Risk Assessment

Create Person - Initiate document validation
Get Reports - Retrieve validation results
Get Report Details - Detailed document data
Update Reports - Refresh document validation

Name Check Reference - Name validation
DOB Check Reference - Date of birth validation
Peru Country Guide - Peru-specific information
Legal Glossary - Legal terminology