> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# DNI

> Consulta DNI por número.



## OpenAPI

````yaml POST /dni
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /dni:
    post:
      tags:
        - dni
      description: Consulta DNI por número.
      operationId: consultaDni
      requestBody:
        required: true
        description: DNI de 8 dígitos del titular a consultar
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dni-request'
      responses:
        '200':
          description: Consulta exitosa. Retorna datos completos de la persona.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dni'
        '404':
          description: >-
            Recurso no encontrado. Puede deberse a DNI inexistente, credenciales
            inválidas o falta de autenticación.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example:
                success: false
                message: No se encontró DNI
components:
  schemas:
    dni-request:
      type: object
      required:
        - dni
      description: >-
        Request body para consulta de DNI. El DNI debe ser un string de 8
        dígitos numéricos.
      properties:
        dni:
          type: string
          description: >-
            Número de Documento Nacional de Identidad (DNI) de 8 dígitos. Debe
            ser numérico y tener exactamente 8 caracteres.
          example: '27427864'
          pattern: ^[0-9]{8}$
          minLength: 8
          maxLength: 8
      example:
        dni: '27427864'
    dni:
      type: object
      description: Respuesta de consulta DNI con datos personales validados
      required:
        - success
        - message
        - data
      properties:
        success:
          type: boolean
          description: Indica si la consulta fue exitosa (true) o falló (false)
          example: true
        message:
          type: string
          description: Mensaje descriptivo del resultado de la consulta
          example: exito
        data:
          type: object
          description: Datos personales del titular del DNI obtenidos
          required:
            - numero
            - codigo_verificacion
            - nombres
            - apellido_paterno
            - apellido_materno
            - nombre_completo
          properties:
            numero:
              type: string
              description: Número de DNI consultado
              example: '27427864'
            codigo_verificacion:
              type: string
              description: Código de verificación del DNI (dígito verificador)
              example: '7'
            nombres:
              type: string
              description: Nombres de pila de la persona
              example: JOSE PEDRO
            apellido_paterno:
              type: string
              description: Primer apellido (apellido paterno) de la persona
              example: CASTILLO
            apellido_materno:
              type: string
              description: Segundo apellido (apellido materno) de la persona
              example: TERRONES
            nombre_completo:
              type: string
              description: 'Nombre completo formateado: APELLIDOS, NOMBRES'
              example: CASTILLO TERRONES, JOSE PEDRO
            direccion:
              type: string
              description: Dirección de la persona
            direccion_completa:
              type: string
              description: Dirección completa de la persona
            ubigeo_reniec:
              type: string
              description: Ubigeo según RENIEC
            ubigeo_sunat:
              type: string
              description: Ubigeo según SUNAT
      example:
        success: true
        message: exito
        data:
          numero: '27427864'
          nombre_completo: CASTILLO TERRONES, JOSE PEDRO
          nombres: JOSE PEDRO
          apellido_paterno: CASTILLO
          apellido_materno: TERRONES
          codigo_verificacion: 7
          direccion: ''
          direccion_completa: ''
          ubigeo_reniec: ''
          ubigeo_sunat: ''
          ubigeo:
            - null
            - null
            - null
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````