# Consulta DNI

### Consideraciones previas

* Este servicio no se conecta con RENIEC.
* El origen de datos depende del padrón reducido SUNAT y otras fuentes públicas consultadas en tiempo real.
* No almacenamos los resultados de consulta DNI.
* No se devuelven datos de menores de edad, dirección, fecha nacimiento, sexo.
* En casos excepcionales algunos números de DNI válidos pueden no retornar resultado, esto no deben considerarse como falla del servicio, la información disponible puede ser limitada en las fuentes públicas consultadas.

## Consulta DNI

<mark style="color:green;">`POST`</mark> `https://diurvanconsultores.com/apidiurvan/api/dniruc`

Consulta de nombres por número de DNI.

#### Headers

| Name          | Type   | Description       |
| ------------- | ------ | ----------------- |
| Authorizarion | string | Bearer {TU TOKEN} |
| Content-Type  | string | application/json  |

#### Request Body

| Name      | Type   | Description |
| --------- | ------ | ----------- |
| documento | string | {TU DNI}    |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "success": true,
    "message": {
        "tipo_documento": "DNI",
        "nro_documento": "EL NRO DNI",
        "nombre_completo": "1ER NOMBRE 2DO NOMBRE AP.PATERNO AP.MATERNO",
        "direccion": "DIRECCION",
        "estado": "",
        "tipo_empresa": "",
        "fecha_inscripcion": "",
        "fecha_inicio": "",
        "condicion": "",
        "actividad_economica": "",
        "estado_civil": "CASADO",
        "ubigeo": "LIMA/LIMA/SANTIAGO DE SURCO",
        "foto": "soon"
    }
}
```

{% endtab %}
{% endtabs %}

### Ejemplos de uso

{% tabs %}
{% tab title="PHP" %}

```php
$diurvan_api_url = "https://diurvanconsultores.com/apidiurvan/api/dniruc";
$header = array( 
  "Content-Type: application/json", 
  "Authorization: Bearer TU TOKEN" 
);

$data = array(
  'documento' => "12345678"
);
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => $diurvan_api_url,
  CURLOPT_HTTPHEADER => $header,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode($data)
));
$dataretorno = curl_exec($curl);
if (curl_errno($curl))
  $retorno = json_decode(curl_error($curl));
else
  $retorno = json_decode($dataretorno);
curl_close($curl);
echo $retorno->message;
```

{% endtab %}
{% endtabs %}

### Visualización en el dashboard

Se visualiza las estadística mensual y también el nro de peticiones por día

![](https://197435032-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MgG3YFF8sowI9zN2Ce5%2F-Mh38IooyYtiuVWcLdbD%2F-Mh39DWPm8z4EUatUNw9%2Fimage.png?alt=media\&token=518f6f78-c713-4896-bb55-5fc6d6ab2c6d)
