PRprobely
Asset Discovery

List Discovered Assets

Changed on

Call auditlog tasks if applicable to query.

get/discovery/assets/

Request

  • Base URL
    https://api.probely.com
  • URL
    https://api.probely.com/discovery/assets/
  • Auth
    API key in header Authorization

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.

unknown

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.

Changes

  • 0b2f6cbe644dRevision changes
    • info

      added the optional property ///////////////// to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property //////////// to the response with the status

  • 0e9b5b5da4d0Revision changes
    • warning

      added the new 40.00 enum value to the // response property for the response status

    • info

      added the enum value 40.00 to the property items/ of the query request parameter risk

    • info

      for the query request parameter source, the type was generalized from string to array

    • info

      added the required property //////////// to the response with the status