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

# DNI

> Consulta la información asociada a un DNI



## OpenAPI

````yaml POST /dni
openapi: 3.1.0
info:
  title: API JSON
  description: Documentación de la API JSON
  version: 1.0.0
servers:
  - url: https://api.json.com.pe
security:
  - bearerAuth: []
paths:
  /dni:
    post:
      summary: Consultar información de un DNI
      description: Consulta la información asociada a un DNI
      requestBody:
        description: Datos necesarios para realizar la consulta.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsultaDniRequest'
            example:
              dni: '12345678'
      responses:
        '200':
          description: Consulta realizada correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConsultaDniResponse'
              example:
                success: true
                message: Exito
                data:
                  numero: '12345678'
                  nombre_completo: PEREZ GOMEZ, JUAN JOSE
                  nombres: JUAN JOSE
                  apellido_paterno: PEREZ
                  apellido_materno: GOMEZ
                  codigo_verificacion: 9
                  direccion: ''
                  direccion_completa: ''
                  ubigeo_reniec: ''
                  ubigeo_sunat: ''
                  ubigeo:
                    - null
                    - null
                    - null
        '404':
          description: No se encontró información para el DNI enviado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDNI'
              example:
                success: false
                message: No se encontró DNI
components:
  schemas:
    ConsultaDniRequest:
      type: object
      required:
        - dni
      properties:
        dni:
          type: string
          description: DNI de 8 dígitos del titular a consultar.
          example: '12345678'
    ConsultaDniResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indica si la consulta fue exitosa.
          example: true
        message:
          type: string
          description: Mensaje descriptivo del resultado.
          example: Exito
        data:
          type: object
          properties:
            numero:
              type: string
              description: Número de documento encontrado.
              example: '27427864'
            nombre_completo:
              type: string
              description: Nombre completo del titular.
              example: PEREZ GOMEZ, JUAN JOSE
            nombres:
              type: string
              description: Nombres de pila de la persona.
              example: JUAN JOSE
            apellido_paterno:
              type: string
              description: Primer apellido (apellido paterno) de la persona.
              example: PEREZ
            apellido_materno:
              type: string
              description: Segundo apellido (apellido materno) de la persona.
              example: GOMEZ
            codigo_verificacion:
              type: string
              description: Código de verificación del DNI (dígito verificador).
              example: '9'
            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.
            ubigeo:
              type: array
              description: Información del ubigeo asociada al titular.
              items:
                type:
                  - string
                  - 'null'
              example:
                - null
                - null
                - null
    ErrorResponseDNI:
      type: object
      properties:
        success:
          type: boolean
          description: Indica si la consulta fue exitosa.
          example: false
        message:
          type: string
          description: Mensaje descriptivo del error.
          example: No se encontró DNI
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````