v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Security Monitoring

List vulnerable assets

Get a list of vulnerable assets.

Pagination

Please review the Pagination section for the "List Vulnerabilities" endpoint.

Filtering

Please review the Filtering section for the "List Vulnerabilities" endpoint.

Metadata

Please review the Metadata section for the "List Vulnerabilities" endpoint.

get/api/v2/security/vulnerable-assets

Query parameters

page[token]string

Its value must come from the links section of the response of the first request. Do not manually edit it.

page[number]integer

The page number to be retrieved. It should be equal or greater than 1

filter[name]string

Filter by name. This field supports the usage of wildcards (*).

The asset type

Example:Repository

Filter by type.

filter[version.first]string

Filter by the first version of the asset since it has been vulnerable.

filter[version.last]string

Filter by the last detected version of the asset.

filter[repository_url]string

Filter by the repository url associated to the asset.

filter[risks.in_production]boolean

Filter whether the asset is in production or not.

filter[risks.under_attack]boolean

Filter whether the asset (Service) is under attack or not.

filter[risks.is_publicly_accessible]boolean

Filter whether the asset (Host) is publicly accessible or not.

filter[risks.has_privileged_access]boolean

Filter whether the asset (Host) has privileged access or not.

filter[risks.has_access_to_sensitive_data]boolean

Filter whether the asset (Host) has access to sensitive data or not.

filter[environments]string

Filter by environment.

filter[teams]string

Filter by teams.

filter[arch]string

Filter by architecture.

filter[operating_system.name]string

Filter by operating system name.

filter[operating_system.version]string

Filter by operating system version.

Response

Example response

{
  "data": [
    {
      "attributes": {
        "arch": "arm64",
        "environments": [
          "staging"
        ],
        "name": "github.com/DataDog/datadog-agent.git",
        "operating_system": {
          "description": "24.04",
          "name": "ubuntu"
        },
        "teams": [
          "compute"
        ],
        "type": "Repository",
        "version": {
          "first": "_latest",
          "last": "_latest"
        }
      },
      "id": "Repository|github.com/DataDog/datadog-agent.git",
      "type": "assets"
    }
  ],
  "links": {
    "first": "https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=1&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4",
    "last": "https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=15&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4",
    "next": "https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=16&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4",
    "previous": "https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=14&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4",
    "self": "https://api.datadoghq.com/api/v2/security/vulnerabilities?filter%5Btool%5D=Infra"
  },
  "meta": {
    "count": 150,
    "token": "b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4",
    "total": 152431
  }
}