Skip to main content
GET
List assets

Authorizations

Authorization
string
header
required

Access token from POST /oauth/token.

Query Parameters

pageSize
integer<int32>

Results per page, 1-100. Defaults to 25.

pageCursor
string

The startCursor or endCursor from a previous page of this list. Send the same filters as on that page. Leave it out for the first page.

categoryKey
enum<string>

Return only assets in this category. Leave it out for all categories.

Available options:
CLOUD,
COMPUTER,
CUSTOM,
INFORMATION,
EMPLOYEE
subKey
enum<string>

Return only assets of this sub-type, such as CLOUD_STORAGE_BUCKET. It's the value an asset returns in categoryKey. If you also send categoryKey, the sub-type must belong to it.

Available options:
CLOUD,
CLOUD_AUTOSCALE_GROUPS,
CLOUD_COMPUTE_INSTANCE,
CLOUD_CONTAINER_REPOSITORY,
CLOUD_DATA_WAREHOUSE,
CLOUD_LOAD_BALANCER,
CLOUD_NO_SQL_DATABASE,
CLOUD_PAAS_APPS,
CLOUD_QUEUE,
CLOUD_RELATIONAL_DATABASE,
CLOUD_STORAGE_BUCKET,
CLOUD_OTHER,
COMPUTER,
CUSTOM,
INFORMATION,
EMPLOYEE
hasOwner
boolean

true returns assets with an owner, false assets without one.

hasDescription
boolean

true returns assets with a description, false assets without one.

classification
enum<string>

Return only assets with this data classification.

Available options:
RESTRICTED,
CONFIDENTIAL,
INTERNAL,
PUBLIC,
UNKNOWN
ownerStatus
enum<string>

Same as hasOwner: COMPLETE returns assets with an owner, INCOMPLETE assets without one.

Available options:
COMPLETE,
INCOMPLETE
auditStatus
enum<string>

Return only assets with this audit status, as shown in the Secfix app. COMPLETE means every field the category needs for an audit is set. Assets without an audit status match neither value.

Available options:
COMPLETE,
INCOMPLETE
externalSource
string

Return only assets created through the API with this externalSource.

externalAssetId
string

Return only the asset with this externalAssetId. Requires externalSource.

Response

Assets returned.

A page of results.

pageInfo
object

Pagination details.

results
object[]

The results on this page.