Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Scopes

discovery:read

Query Parameters

search
string

Filter assets by host name or page title (case-insensitive substring match).

status
enum<string>
default:new

Filter by triage status. The default is new.

Available options:
new,
imported,
ignored,
all
source
enum<string>

Filter by the source that found the asset. How the asset was found. integration is reserved for assets that an external inventory, for example a cloud security platform, writes into Strix.

Available options:
certificate_transparency,
tls_certificate,
passive_dns,
reverse_dns,
subfinder,
asn,
http_probe,
integration,
manual
kind
enum<string>

Filter by asset kind.

Available options:
apex,
subdomain,
wildcard,
ip,
netblock,
service
apex
string

Filter by the apex domain the asset belongs to.

run_id
string<uuid>

Return only the assets that a specific run found.

sort_by
enum<string>
default:first_seen_at

Field to sort by. Defaults to first_seen_at descending, newest discoveries first. last_seen_at orders by the most recent sighting.

Available options:
last_seen_at,
first_seen_at
sort_order
enum<string>
default:desc

Sort direction. Use asc for oldest first or desc for newest first.

Available options:
asc,
desc
limit
integer
default:100

Maximum number of assets to return. The default is 100 and the maximum is 200.

Required range: 1 <= x <= 200
offset
integer
default:0

Number of assets to skip.

Required range: x >= 0

Response

The filtered inventory.

assets
object[]
required
total
integer
required

The number of assets that match the filters.

apexes
string[]
required

The apex domains in the inventory, for the apex filter.

limit
integer
required
offset
integer
required