Find assets by search terms and filters

List all the assets

Securitybearer
Request
query Parameters
page
number
Default: 1

Which page of data are you requesting

Example: page=1
limit
number <= 50
Default: 20

How many items are your requesting

Example: limit=10
nextPage
string

The next page Uri

Example: nextPage=d2lraS9hcGkvdjIvcGFnZXM/bGltaXQ9MTAmY3Vyc29yPWV5SnBaQ0k2SWpJM05USTJPVGdpTENKamIyNTBSUGNtUmxjbFpoYkhWbElqb3lOelV5TmprNGZRPT0=
q
string

Filter data by searching by asset names

Example: q=Security Program Overview
sort
string

Which type of sort (default: CREATED)

Enum: "NAME" "ASSET_TYPE" "COMPANY_NAME" "DESCRIPTION" "ASSET_PROVIDER" "USER" "APPROVED_AT" "REMOVED_AT" "CREATED" "UPDATED" "EMPLOYMENT_STATUS"
Example: sort=NAME
sortDir
string

Which direction to sort the data (default: ASC)

Enum: "ASC" "DESC"
Example: sortDir=ASC
assetClassType
string

Filter assets by class type (associated assets)

Enum: "HARDWARE" "POLICY" "DOCUMENT" "PERSONNEL" "SOFTWARE" "CODE" "CONTAINER" "COMPUTE" "NETWORKING" "DATABASE" "STORAGE"
Example: assetClassType=DOCUMENT
assetType
string

Filter assets by type

Enum: "PHYSICAL" "VIRTUAL"
Example: assetType=PHYSICAL
assetProvider
string

Filter assets by provider

Enum: "DRATA_DEV" "AGENT" "DRATA" "GOOGLE" "MICROSOFT_365" "JAMF" "INTUNE" "OKTA_IDENTITY" "KANDJI" "JUMPCLOUD" "HEXNODE_UEM" "RIPPLING" "AWS" "MERGEDEV_ONELOGIN" "MERGEDEV_JUMPCLOUD" "WORKSPACE_ONE" "CSV_IDP" "AWS_GOV_CLOUD"
Example: assetProvider=AGENT
userId
number <= 1000000000

Filter data to a user associated to the assets

Example: userId=1
employmentStatus
string

Filter data to personnel of this employment status

Enum: "CURRENT_EMPLOYEE" "FORMER_EMPLOYEE" "CURRENT_CONTRACTOR" "FORMER_CONTRACTOR" "OUT_OF_SCOPE" "UNKNOWN" "SPECIAL_FORMER_EMPLOYEE" "SPECIAL_FORMER_CONTRACTOR" "FUTURE_HIRE"
Example: employmentStatus=CURRENT_EMPLOYEE
Responses
200
401

Invalid Authorization

403

You are not allowed to perform this action

500

Internal server error

default

Response Code: 412

You must accept the Drata terms and conditions to use the API

get/public/assets
Request samples 
Response samples 
application/json
{
  • "data": [ ],
  • "page": 1,
  • "limit": 10,
  • "total": 100,
  • "nextPage": "d2lraS9hcGkvdjIvcGFnZXM/bGltaXQ9MTAmY3Vyc29yPWV5SnBaQ0k2SWpJM05USTJPVGdpTENKamIyNTBSUGNtUmxjbFpoYkhWbElqb3lOelV5TmprNGZRPT0="
}