ASI Assets: Get Filters

Discover available filter facets and their values across all project assets.

What this endpoint does

Retrieve the available filter facets for a project's assets, including the distinct values for each filter field and the number of assets matching each value. This is a discovery endpoint — use it to understand what filter criteria are available before constructing queries with the Find Assets or Search Assets endpoints. By default, it returns facets for asset type, custom tags, IP owner, exposure severity, open port numbers, and certificate expiration; use the filter_fields query parameter to request specific facets from the full set of 24 available fields covering asset identity, network infrastructure, certificates, exposures, and technologies.

Response data

Returns filter facets organized by property group (asset, certificate, exposure, technology). Each facet includes a human-readable name, the query parameter name for the Find Assets endpoint, the dotted JSON path for constructing Search Assets POST filters, the operator type (eq, in, or date_range), and an array of available values with their asset counts. Date-range facets include pre-computed time windows (e.g., "Last 30 days", "Next 90 days") with start and end dates.

Path Params
string
required
Query Params
array | null

A list of additional fields to include in the response.You may specify this field multiple times or pass a comma-separated list from: asset_type, asn, custom_tags, added_to_project, discovered, apex, ip_geo_country_iso, ip_owner, static_asset, registry, referenced_ip, exposure_id, severity, asset_exposure_score, last_scanned_at, open_port_number, open_port_service, open_port_protocol, waf_detected, waf_name, technology_name, is_responsive, certificate_issuer, certificate_expires_at, certificate_issued_at.By default asset_type, custom_tags, ip_owner, severity, open_port_number, certificate_expires_at is returned.If one query input is equal to all, all fields are returned.

Responses

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