Overview
The Assets endpoint returns all scanned assets in your Lupasafe account — including domains and network devices — along with their IP addresses, OS type, EPSS risk score, importance rating, and tags.
Base URL: https://portal.lupasafe.com
Authentication: X-Api-Key: ls_your_api_key_here
Endpoint
| Endpoint | Description |
|---|---|
GET /reporting/v1/assets | All scanned assets — domains and network devices with IP, OS type, EPSS score, importance, tags |
Parameters
- limit — default 50, max 500
- offset — for pagination
Response Fields
| Field | Description |
|---|---|
asset_id | Unique identifier for the asset |
name | Domain name or device identifier |
ip_v4 | IPv4 address |
ip_v6 | IPv6 address |
os | Scanner type: DomainScanner or NetworkScanner |
epss | Exploit Prediction Scoring System score (0–100, probability of exploit within 30 days) |
importance | Priority level (1–5) |
tags | Location and type tags assigned to the asset |
last_seen_on | Timestamp of the last scan |
Example Request
GET /reporting/v1/assets?limit=10
X-Api-Key: ls_your_api_key_hereNotes
- The
epssscore represents the probability that a vulnerability on this asset will be exploited within the next 30 days. Higher scores indicate higher risk. - The
importancefield (1–5) allows you to prioritise remediation — 5 being the highest priority. - Assets are discovered by Lupasafe's DomainScanner (for web domains) and NetworkScanner (for internal network devices).
- Use
tagsto group assets by location, business unit, or environment (e.g.,location:Amsterdam,type:server). - MSP keys return assets across all client accounts; client keys return only that client's assets.