List all the assets

Find assets by search terms and filters

🔒 Requires Assets: List Assets permission.

Securitybearer
Request
query Parameters
page
number [ 1 .. 1000 ]
Default: 1

Which page of data are you requesting

limit
number [ 1 .. 50 ]
Default: 20

How many items are you requesting

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" "AZURE" "GCP" "MICROSOFT_365_GCC_HIGH" "MERGEDEV_CYBERARK" "KOLIDE" "MERGEDEV_PINGONE" "AWS_ORG_UNITS" "INTUNE_GCC_HIGH"
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" "SERVICE_ACCOUNT"
Example: employmentStatus=CURRENT_EMPLOYEE
Responses
200
401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

412

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

500

Internal server error

get/assets
Request samples 
Response samples 
application/json
{
  • "data": [
    • {
      • "id": 1,
      • "name": "MacbookPro 13",
      • "description": "MacbookPro 13",
      • "assetType": "PHYSICAL",
      • "assetProvider": "AGENT",
      • "approvedAt": "2025-07-01T16:45:55.246Z",
      • "removedAt": "2025-07-01T16:45:55.246Z",
      • "assetClassTypes": "AssetClassTypeResponseDto[]",
      • "company": "Acme, Inc",
      • "owner": {
        • "id": 1,
        • "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
        • "email": "[email protected]",
        • "firstName": "Sally",
        • "lastName": "Smith",
        • "jobTitle": "CEO",
        • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
        • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
        • "createdAt": "2025-07-01T16:45:55.246Z",
        • "updatedAt": "2025-07-01T16:45:55.246Z",
        • "roles": [
          • "ROLE",
          • "ANOTHER_ROLE"
          ],
        • "backgroundChecks": [
          • {
            • "id": 1,
            • "userId": 1,
            • "status": "OK",
            • "caseId": "abc123",
            • "caseInvitationId": "abc123",
            • "url": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
            • "manualCheckDate": "2020-07-06",
            • "manuallyCheckUrl": "url.com",
            • "type": "CERTN",
            • "source": "DRATA",
            • "reportData": "string",
            • "user": { },
            • "outOfScopeReason": "abc123",
            • "outOfScopeAt": "2025-07-01T16:45:55.246Z",
            • "invitationEmail": "[email protected]",
            • "linkedAt": "2025-07-01T16:45:55.246Z",
            • "createdAt": "2025-07-01T16:45:55.246Z",
            • "updatedAt": "2025-07-01T16:45:55.246Z"
            }
          ],
        • "identities": [
          • {
            • "id": 1,
            • "identityId": "1a2b3c",
            • "username": "Username",
            • "connectedAt": "2025-07-01T16:45:55.246Z",
            • "disconnectedAt": "2025-07-01T16:45:55.246Z",
            • "hasMfa": true,
            • "user": { },
            • "connection": {
              • "id": "1",
              • "clientType": "GOOGLE",
              • "state": "ACTIVE",
              • "connected": false,
              • "connectedAt": "2025-07-01T16:45:55.246Z",
              • "failedAt": "2025-07-01T16:45:55.246Z",
              • "companyId": "12341234",
              • "assignmentId": "FLk12AsS",
              • "user": { },
              • "accountId": "string",
              • "clientId": "abc123",
              • "clientAlias": "My-connection-alias-1",
              • "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
              • "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
              • "deletedAt": "2025-07-01T16:45:55.246Z",
              • "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
              • "product": { },
              • "writeAccessEnabled": false,
              • "sourcePreference": "LABEL",
              • "securityLabel": "Jira Security Label",
              • "jqlQuery": "project = IT AND type = \"Offboarding\"",
              • "authorized": true,
              • "workspaces": [],
              • "providerTypes": [
                • 5
                ],
              • "code": 10010,
              • "groupLabel": "Everyone"
              },
            • "hasIdp": true,
            • "secondaryEmail": "[email protected]",
            • "firstName": "John",
            • "lastName": "Doe",
            • "startedAt": "2025-07-01T16:45:55.246Z",
            • "separatedAt": "2025-07-01T16:45:55.246Z",
            • "isContractor": true,
            • "jobTitle": "Engineer",
            • "managerId": "x00jk12-2312",
            • "managerName": "string"
            }
          ],
        • "documents": [
          • {
            • "data": [
              • {
                • "id": null,
                • "name": null,
                • "type": null,
                • "fileUrl": null,
                • "renewalDate": null,
                • "createdAt": null,
                • "updatedAt": null
                }
              ],
            • "page": 1,
            • "limit": 10,
            • "total": 100
            }
          ]
        },
      • "employmentStatus": "CURRENT_EMPLOYEE",
      • "notes": "string",
      • "assetReferenceType": "PERSONNEL",
      • "uniqueId": "C02T6CDJGTFL",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z",
      • "device": {
        • "id": 1,
        • "osVersion": "MacOS 10.15.6",
        • "serialNumber": "C02T6CDJGTFL",
        • "model": "MacBook Pro",
        • "macAddress": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
        • "encryptionEnabled": false,
        • "encryptionExplanation": "No encryption provided",
        • "firewallEnabled": true,
        • "firewallExplanation": "{}",
        • "lastCheckedAt": "2025-07-01T16:45:55.246Z",
        • "sourceType": "AGENT",
        • "createdAt": "2025-07-01T16:45:55.246Z",
        • "updatedAt": "2025-07-01T16:45:55.246Z",
        • "deletedAt": "2025-07-01T16:45:55.246Z",
        • "appsCount": 20,
        • "complianceChecks": [ ],
        • "identifiers": [ ],
        • "documents": [ ],
        • "isDeviceCompliant": false,
        • "screenLockTime": "60",
        • "screenLockExplanation": {
          • "minutesIdleBeforeSleep": "2",
          • "minutesSleepingBeforePasswordIsRequired": "2"
          },
        • "antivirusEnabled": true,
        • "antivirusExplanation": "No matching app was found",
        • "autoUpdateEnabled": true,
        • "autoUpdateExplanation": "No compliances found",
        • "passwordManagerEnabled": true,
        • "passwordManagerExplanation": {
          • "passwordManagerApps": [
            • "1password 7"
            ]
          },
        • "agentVersion": "1.0"
        },
      • "externalId": "i-0c844e3b433e4e3f",
      • "externalOwnerId": "account-353"
      }
    ],
  • "page": 1,
  • "limit": 10,
  • "total": 100
}