---
title: "POST /dni"
method: POST
path: "/dni"
tags: ["dni"]
---

# POST /dni

`POST /dni`

Consulta DNI por número.

## Request body

- DniRequest — Request body para consulta de DNI. El DNI debe ser un string de 8 dígitos numéricos.
  - `dni` string, required — Número de Documento Nacional de Identidad (DNI) de 8 dígitos. Debe ser numérico y tener exactamente 8 caracteres.

## Response `200`

Consulta exitosa. Retorna datos completos de la persona.

- Dni — Respuesta de consulta DNI con datos personales validados
  - `success` boolean, required — Indica si la consulta fue exitosa (true) o falló (false)
  - `message` string, required — Mensaje descriptivo del resultado de la consulta
  - `data` object, required — Datos personales del titular del DNI obtenidos
    - `numero` string, required — Número de DNI consultado
    - `codigo_verificacion` string, required — Código de verificación del DNI (dígito verificador)
    - `nombres` string, required — Nombres de pila de la persona
    - `apellido_paterno` string, required — Primer apellido (apellido paterno) de la persona
    - `apellido_materno` string, required — Segundo apellido (apellido materno) de la persona
    - `nombre_completo` string, required — Nombre completo formateado: APELLIDOS, NOMBRES
    - `direccion` string — Dirección de la persona
    - `direccion_completa` string — Dirección completa de la persona
    - `ubigeo_reniec` string — Ubigeo según RENIEC
    - `ubigeo_sunat` string — Ubigeo según SUNAT

## Other responses

- `404` — Recurso no encontrado. Puede deberse a DNI inexistente, credenciales inválidas o falta de autenticación.

---

[API](https://skmtc.net/json/apis/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir.md) · [All operations](https://skmtc.net/json/apis/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/json/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir/revisions/7d6e90afad50/schema)