v1

latestOpenAPI 3.0.32026-07-134103031.5 MB
Asset Discovery

List Discovered Assets

Call auditlog tasks if applicable to query.

get/discovery/assets/

Query parameters

has_targetboolean

If true, filter results by discovered assets with a target created.
If false, filter results by discovered assets with no target created.
If not specified, this filter is ignored.

labelstring[]

Target label IDs of discovered assets to filter results, as a query string.

label_logical_operator'and' | 'or'

Logical operator to apply between target labels:
(Defaults to or)

  • and - and
  • or - or
lengthinteger

Number of results to return per page.

orderingstring

Which field to use when ordering the results.

ownerstring[]

Owner labels to filter results, as a query string.
For example, "owner=Admin" or "owner=Admin&owner=QA".

owner_logical_operator'and' | 'or'

Logical operator to apply between owner labels:
(Defaults to or)

  • and - and
  • or - or
pageinteger

A page number within the paginated result set.

{"stackTrail":"paths:/discovery/assets/:get:parameters:8:schema:items","oasType":"schema","type":"unknown","extensionFields":{"x-spec-enum-id":"d833b57a93cd87f3"},"nullable":true}

Scan assessment risk of discovered assets to filter results:

  • None - Not applicable.
  • 0 - No risk.
  • 10 - Low risk.
  • 20 - Medium risk.
  • 30 - High risk.
  • 40 - Critical risk.
scorestring[]

Security Headers assessment score of discovered assets to filter results:

  • `` -
  • A+ - A+
  • A - A
  • B - B
  • C - C
  • D - D
  • E - E
  • F - F
  • R - R
  • NA - NA
searchstring

A search term.

sourcestring[]

Source of discovered assets to filter results.

statestring[]

State of discovered assets to filter results:

  • NEW - New
  • ACTIVE - Active
  • HIDDEN - Hidden
  • ARCHIVED - Archived
technologystring

Technology found in the discovered assets to filter results.

typestring[]

Type of discovered assets to filter results:

  • web - Web
  • api - API

Response

countinteger

Total number of results.

page_totalinteger

Total number of pages.

pageinteger

Number of the current page.
The first page is 1.
Defaults to 1 if no specific page is requested.

lengthinteger

Number of results returned per page.