Consultar DNI

Obtén el nombre y apellidos asociados a un DNI.

Qué enviar


Método	`GET`
URL	`https://apis.facturalibre.org/api/dni/{dni}`
`{dni}`	Número de 8 dígitos
Cabeceras	`Authorization: Bearer {tu_token}` y `Accept: application/json`

Ejemplo:

curl -sS -H "Authorization: Bearer TOKEN" -H "Accept: application/json" \
  "https://apis.facturalibre.org/api/dni/45897656"

Si todo salió bien

Respuesta HTTP 200:

{
  "success": true,
  "data": {
    "numero": "45897656",
    "nombre_completo": "VIGO ALVAN XUXAN MELINA",
    "nombres": "XUXAN MELINA",
    "apellido_paterno": "VIGO",
    "apellido_materno": "ALVAN",
    "codigo_verificacion": "8"
  },
  "source": "facturalibre.org"
}

En data solo vienen esos seis campos.

Si no se encuentra o el dato no es válido

Sigue siendo HTTP 200, pero con success: false.

El DNI no tiene 8 dígitos:

{
  "success": false,
  "message": "DNI tiene 8 digitos."
}

No se encuentra en SUNAT:

{
  "success": false,
  "message": "No se encuentra en SUNAT."
}

(El texto exacto del mensaje puede variar ligeramente; lo importante es success: false y leer message.)

Los errores de cupo, plan o cuenta suspendida están en el documento padre API Consulta RUC.

Si no hay respuesta

Si la petición no obtiene respuesta (timeout, red, etc.), tu cliente verá un error de conexión y no el JSON habitual con success. Reintenta más tarde.