Carnet de extranjería, pasaporte y cédula diplomática
Busca en el portal público de SUNAT al contribuyente registrado con uno de estos documentos. Solo se encuentran personas inscritas en SUNAT (con RUC).
POST https://api.factosperu.com/api/v1/carnet-extranjeria
POST https://api.factosperu.com/api/v1/pasaporte
POST https://api.factosperu.com/api/v1/cedula-diplomatica
Solicitud
Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.
{ "numero": "001234567" }
El campo numero es obligatorio: de 4 a 15 letras o dígitos, sin espacios ni guiones. Se convierte a mayúsculas.
Respuesta
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"tipo_documento": "carnet-extranjeria",
"numero": "…",
"nombre_completo": "…",
"nombres": "…",
"apellido_paterno": "…",
"apellido_materno": "…",
"ruc": "…",
"estado": "…",
"ubicacion": "…"
},
"source": "sunat_en_linea",
"time": 0.4
}
Códigos
200: encontrado.404not_found: no hay un contribuyente registrado con ese documento.422: número inválido (invalid_documento) o campo faltante.503fuente_desactivada/no_disponible: la consulta en línea está apagada o no disponible; reintentable.502proveedor_error: error del proveedor; reintentable.
Cada solicitud consume 1 unidad. El RUC y el DNI tienen sus propias rutas (RUC, DNI), que primero consultan el padrón reducido.