ASI Assets: Read

Retrieve the full risk profile for a single asset with optional enrichment fields.

What this endpoint does

Retrieve the full detail view of a single asset within a project. The asset_id path parameter is the asset's domain name or IP address (as returned by ASI Assets: Find or ASI Assets: Search), not a UUID. By default, the response includes core identity and scoring data; use the additional_fields parameter to enrich the response with DNS records, WHOIS data, open TCP/UDP ports with service identification, web technologies, TLS certificates and certificate chains, defensive controls (such as WAF detection), and detailed exposure instances. This is the primary endpoint for building an asset risk profile or investigating a specific host.

Response data

Returns a comprehensive risk profile for a single attack surface asset — everything needed to assess its security posture and prioritize remediation. The exposure score (0–100) gives an at-a-glance risk ranking, while the enrichment fields (requested via additional_fields) reveal the evidence behind that score: which ports are open and what services are running, what vulnerabilities or misconfigurations have been detected and on which ports, whether defensive controls like WAFs are in place, and how the asset's DNS and certificate infrastructure is configured. The asset's ID is reusable across all ASI Project API endpoints for tagging, exposure detail retrieval, and search filtering.

Path Params
string
required
string
required

Filter for the specific asset, which will be either a IP or domain value (examples: 192.88.99.2 or www.example.com).

Query Params
additional_fields
array of strings

A list of additional fields to include in the response from the following. You may specify this field multiple times or pass a comma-separated list from: custom_tags, dns_records, whois, ip_metadata, open_tcp_ports, open_udp_ports, web_technologies, certificates, certificate_chain, defenses, exposures, exposure_instance_details. By default the custom tags will be returned.

Additional Fields
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json