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.
