Malwarebytes Vulnerability Management API
The Vulnerability Management API from Malwarebytes — 14 operation(s) for vulnerability management.
OpenAPI Specification
openapi: 3.2.0
info:
title: Malwarebytes Vulnerability Management API
version: 1.0.0
description: 'Operations tagged Vulnerability Management across 2 of this provider''s published API definitions: malwarebytes-threatdown-nebula-openapi.json, malwarebytes-threatdown-oneview-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.threatdown.com
tags:
- name: Vulnerability Management
paths:
/nebula/v1/cve/export:
servers:
- url: https://api.threatdown.com
post:
description: "Export CVE data. You can export across multiple accounts. Specify your interested fields and the output format.\n\nSupported output formats: csv, xlsx, json.\n\n## Settings\n\n| Name | Description |\n|------|-------------|\n| groups | List of queries. The constraints accepted are the same accepted by the search assets software route. Refer to [Search CVE API](#operation/api.nebula.search.cve) for more information about the constraints accepted. |\n| download | If set to true, the server will set the `Content-Disposition` header using the `filename` and `format` |\n| select | Which fields to select, and which field name to map to. See request schema for allowed values |\n| type | Output encoding (for `csv` and `json` format) |\n| filename | Name of the file to be set in `Content-Disposition` header if `download` = true |\n\n## Examples\n\n### Download HTML file\n\nA request with this body sent by a browser will download a file called `nameofthefile.html`, displaying a table with columns: `Path`, `Name`, `Machine ID`, `Machine Name` for all detections on `windows` endpoints within account id `1e14cd0a-2ef3-4db3-b8a4-c89894d9aa34`:\n\n```json\n\t{\n\t\t\"groups\": [{\n\t\t\t\"severity\": \"critical\"\n\t\t}],\n\t\t\"format\": \"html\",\n\t\t\"type\": \"string\",\n\t\t\"filename\": \"nameofthefile\",\n\t\t\"download\": true,\n\t\t\"select\": [\n {\"field\": \"account_id\", \"newField\": \"account_id\"},\n {\"field\": \"group_id\", \"newField\": \"groupId\"},\n {\"field\": \"vendor\", \"newField\": \"vendor\"},\n {\"field\": \"product\", \"newField\": \"product\"},\n {\"field\": \"installation_date\", \"newField\": \"installationDate\"},\n {\"field\": \"created_at\", \"newField\": \"createdAt\"}\n ]\n\t}\n```\n\n\n"
summary: Export CVE data
security:
- client_credentials:
- execute
- user_permissions:
- vulnerabilities.view
status:
outage:
- auth
- search_stateless
parameters:
- name: authorization
required: true
in: header
description: Authorization token
schema:
type: string
- name: accountid
required: true
in: header
description: Your Nebula account id (Ex. "9256034b-7967-4253-a5d9-260663e4fa4f")
schema:
type: string
pattern: '[\da-fA-F]{8}-?[\da-fA-F]{4}-?[\da-fA-F]{4}-?[\da-fA-F]{4}-?[\da-fA-F]{12}$'
requestBody:
content:
application/json:
schema:
type: object
title: Export request
required:
- groups
- select
- format
properties:
format:
type: string
title: The output file
enum:
- csv
- xlsx
- html
- ods
- txt
- rtf
- json
download:
type: boolean
title: Whether to instruct the client to download the response as a file. Only clients like browsers are supported
type:
type: string
title: The encoding of the output
enum:
- string
- base64
- binary
default: string
select:
type: array
title: Which fields to select from the response
items:
type: object
title: Field
required:
- field
- newField
properties:
newField:
type: string
title: the new value
field:
type: string
title: The response field to map to a new value
enum:
- account_id
- account_name
- parent_account_id
- group_id
- root_group_id
- group_name
- machine_id
- vendor
- normalized_vendor
- display_vendor
- product
- normalized_product
- display_product
- installed_version
- normalized_installed_version
- display_installed_version
- installation_date
- host_name
- fully_qualified_host_name
- domain_name
- alias
- created_at
- os_info.os_type
- os_info.os_version
- os_info.os_platform
- os_info.os_architecture
- os_info.os_release_name
- cve_id
- cisa_exploitable
- known_ransomware_campaign_use
- severity
- severity_score
- published_at
- description
- cvss20_score
- cvss30_score
- latest_version_available
- product_signature
- architecture
- language
- supports_update
- supports_uninstall
- ignored_until
- ignored_by
- ignored_by_name
- ignored_reason
- ignored_at
- active_directory.user.display_name
- active_directory.user.sam_account_name
- active_directory.user.ou
- active_directory.machine.display_name
- active_directory.machine.sam_account_name
- active_directory.machine.ou
groups:
type: array
title: List of queries
items:
type: object
title: Query to fetch CVEs
allOf:
- type: object
title: Search assets cve request. Leading wildcards are not supported for constraint fields without '.keyword' suffix.
properties:
account_name:
type: string
title: Filter the search by account_name. Search for an exact match
account_name.keyword:
type: string
title: Filter the search by account_name.keyword. Search for the matches that contain the value
not.account_name:
type: string
title: Filter the search by not.account_name. Search for the matches that are not equal to the value
not.account_name.keyword:
type: string
title: Filter the search by not.account_name.keyword. Search for the matches that do not contain the value
parent_account_id:
type: string
title: Filter the search by parent_account_id. Search for an exact match
parent_account_id.keyword:
type: string
title: Filter the search by parent_account_id.keyword. Search for the matches that contain the value
not.parent_account_id:
type: string
title: Filter the search by not.parent_account_id. Search for the matches that are not equal to the value
not.parent_account_id.keyword:
type: string
title: Filter the search by not.parent_account_id.keyword. Search for the matches that do not contain the value
group_id:
type: string
title: Filter the search by group_id. Search for an exact match
group_id.keyword:
type: string
title: Filter the search by group_id.keyword. Search for the matches that contain the value
not.group_id:
type: string
title: Filter the search by not.group_id. Search for the matches that are not equal to the value
not.group_id.keyword:
type: string
title: Filter the search by not.group_id.keyword. Search for the matches that do not contain the value
root_group_id:
type: string
title: Filter the search by root_group_id. Search for an exact match
root_group_id.keyword:
type: string
title: Filter the search by root_group_id.keyword. Search for the matches that contain the value
not.root_group_id:
type: string
title: Filter the search by not.root_group_id. Search for the matches that are not equal to the value
not.root_group_id.keyword:
type: string
title: Filter the search by not.root_group_id.keyword. Search for the matches that do not contain the value
group_name:
type: string
title: Filter the search by group_name. Search for an exact match
group_name.keyword:
type: string
title: Filter the search by group_name.keyword. Search for the matches that contain the value
not.group_name:
type: string
title: Filter the search by not.group_name. Search for the matches that are not equal to the value
not.group_name.keyword:
type: string
title: Filter the search by not.group_name.keyword. Search for the matches that do not contain the value
machine_id:
type: string
title: Filter the search by machine_id. Search for an exact match
machine_id.keyword:
type: string
title: Filter the search by machine_id.keyword. Search for the matches that contain the value
not.machine_id:
type: string
title: Filter the search by not.machine_id. Search for the matches that are not equal to the value
not.machine_id.keyword:
type: string
title: Filter the search by not.machine_id.keyword. Search for the matches that do not contain the value
object_guid:
type: string
title: Filter the search by object_guid. Search for an exact match
object_guid.keyword:
type: string
title: Filter the search by object_guid.keyword. Search for the matches that contain the value
not.object_guid:
type: string
title: Filter the search by not.object_guid. Search for the matches that are not equal to the value
not.object_guid.keyword:
type: string
title: Filter the search by not.object_guid.keyword. Search for the matches that do not contain the value
host_name:
type: string
title: Filter the search by host_name. Search for an exact match
host_name.keyword:
type: string
title: Filter the search by host_name.keyword. Search for the matches that contain the value
not.host_name:
type: string
title: Filter the search by not.host_name. Search for the matches that are not equal to the value
not.host_name.keyword:
type: string
title: Filter the search by not.host_name.keyword. Search for the matches that do not contain the value
fully_qualified_host_name:
type: string
title: Filter the search by fully_qualified_host_name. Search for an exact match
fully_qualified_host_name.keyword:
type: string
title: Filter the search by fully_qualified_host_name.keyword. Search for the matches that contain the value
not.fully_qualified_host_name:
type: string
title: Filter the search by not.fully_qualified_host_name. Search for the matches that are not equal to the value
not.fully_qualified_host_name.keyword:
type: string
title: Filter the search by not.fully_qualified_host_name.keyword. Search for the matches that do not contain the value
domain_name:
type: string
title: Filter the search by domain_name. Search for an exact match
domain_name.keyword:
type: string
title: Filter the search by domain_name.keyword. Search for the matches that contain the value
not.domain_name:
type: string
title: Filter the search by not.domain_name. Search for the matches that are not equal to the value
not.domain_name.keyword:
type: string
title: Filter the search by not.domain_name.keyword. Search for the matches that do not contain the value
alias:
type: string
title: Filter the search by alias. Search for an exact match
alias.keyword:
type: string
title: Filter the search by alias.keyword. Search for the matches that contain the value
not.alias:
type: string
title: Filter the search by not.alias. Search for the matches that are not equal to the value
not.alias.keyword:
type: string
title: Filter the search by not.alias.keyword. Search for the matches that do not contain the value
sort_name:
type: string
title: Filter the search by sort_name. Search for an exact match
sort_name.keyword:
type: string
title: Filter the search by sort_name.keyword. Search for the matches that contain the value
not.sort_name:
type: string
title: Filter the search by not.sort_name. Search for the matches that are not equal to the value
not.sort_name.keyword:
type: string
title: Filter the search by not.sort_name.keyword. Search for the matches that do not contain the value
vendor:
type: string
title: Filter the search by vendor. Search for an exact match
vendor.keyword:
type: string
title: Filter the search by vendor.keyword. Search for the matches that contain the value
not.vendor:
type: string
title: Filter the search by not.vendor. Search for the matches that are not equal to the value
not.vendor.keyword:
type: string
title: Filter the search by not.vendor.keyword. Search for the matches that do not contain the value
normalized_vendor:
type: string
title: Filter the search by normalized_vendor. Search for an exact match
normalized_vendor.keyword:
type: string
title: Filter the search by normalized_vendor.keyword. Search for the matches that contain the value
not.normalized_vendor:
type: string
title: Filter the search by not.normalized_vendor. Search for the matches that are not equal to the value
not.normalized_vendor.keyword:
type: string
title: Filter the search by not.normalized_vendor.keyword. Search for the matches that do not contain the value
display_vendor:
type: string
title: Filter the search by display_vendor. Search for an exact match
display_vendor.keyword:
type: string
title: Filter the search by display_vendor.keyword. Search for the matches that contain the value
not.display_vendor:
type: string
title: Filter the search by not.display_vendor. Search for the matches that are not equal to the value
not.display_vendor.keyword:
type: string
title: Filter the search by not.display_vendor.keyword. Search for the matches that do not contain the value
product:
type: string
title: Filter the search by product. Search for an exact match
product.keyword:
type: string
title: Filter the search by product.keyword. Search for the matches that contain the value
not.product:
type: string
title: Filter the search by not.product. Search for the matches that are not equal to the value
not.product.keyword:
type: string
title: Filter the search by not.product.keyword. Search for the matches that do not contain the value
normalized_product:
type: string
title: Filter the search by normalized_product. Search for an exact match
normalized_product.keyword:
type: string
title: Filter the search by normalized_product.keyword. Search for the matches that contain the value
not.normalized_product:
type: string
title: Filter the search by not.normalized_product. Search for the matches that are not equal to the value
not.normalized_product.keyword:
type: string
title: Filter the search by not.normalized_product.keyword. Search for the matches that do not contain the value
display_product:
type: string
title: Filter the search by display_product. Search for an exact match
display_product.keyword:
type: string
title: Filter the search by display_product.keyword. Search for the matches that contain the value
not.display_product:
type: string
title: Filter the search by not.display_product. Search for the matches that are not equal to the value
not.display_product.keyword:
type: string
title: Filter the search by not.display_product.keyword. Search for the matches that do not contain the value
installed_version:
type: string
title: Filter the search by installed_version. Search for an exact match
installed_version.keyword:
type: string
title: Filter the search by installed_version.keyword. Search for the matches that contain the value
not.installed_version:
type: string
title: Filter the search by not.installed_version. Search for the matches that are not equal to the value
not.installed_version.keyword:
type: string
title: Filter the search by not.installed_version.keyword. Search for the matches that do not contain the value
normalized_installed_version:
type: string
title: Filter the search by normalized_installed_version. Search for an exact match
normalized_installed_version.keyword:
type: string
title: Filter the search by normalized_installed_version.keyword. Search for the matches that contain the value
not.normalized_installed_version:
type: string
title: Filter the search by not.normalized_installed_version. Search for the matches that are not equal to the value
not.normalized_installed_version.keyword:
type: string
title: Filter the search by not.normalized_installed_version.keyword. Search for the matches that do not contain the value
display_installed_version:
type: string
title: Filter the search by display_installed_version. Search for an exact match
display_installed_version.keyword:
type: string
title: Filter the search by display_installed_version.keyword. Search for the matches that contain the value
not.display_installed_version:
type: string
title: Filter the search by not.display_installed_version. Search for the matches that are not equal to the value
not.display_installed_version.keyword:
type: string
title: Filter the search by not.display_installed_version.keyword. Search for the matches that do not contain the value
os_info.os_type:
type: string
title: Filter the search by os_info.os_type. Search for an exact match
os_info.os_type.keyword:
type: string
title: Filter the search by os_info.os_type.keyword. Search for the matches that contain the value
not.os_info.os_type:
type: string
title: Filter the search by not.os_info.os_type. Search for the matches that are not equal to the value
not.os_info.os_type.keyword:
type: string
title: Filter the search by not.os_info.os_type.keyword. Search for the matches that do not contain the value
os_info.os_version:
type: string
title: Filter the search by os_info.os_version. Search for an exact match
os_info.os_version.keyword:
type: string
title: Filter the search by os_info.os_version.keyword. Search for the matches that contain the value
not.os_info.os_version:
type: string
title: Filter the search by not.os_info.os_version. Search for the matches that are not equal to the value
not.os_info.os_version.keyword:
type: string
title: Filter the search by not.os_info.os_version.keyword. Search for the matches that do not contain the value
os_info.os_platform:
type: string
title: Filter the search by os_info.os_platform. Search for an exact match
os_info.os_platform.keyword:
type: string
title: Filter the search by os_info.os_platform.keyword. Search for the matches that contain the value
not.os_info.os_platform:
type: string
title: Filter the search by not.os_info.os_platform. Search for the matches that are not equal to the value
not.os_info.os_platform.keyword:
type: string
title: Filter the search by not.os_info.os_platform.keyword. Search for the matches that do not contain the value
os_info.os_architecture:
type: string
title: Filter the search by os_info.os_architecture. Search for an exact match
os_info.os_architecture.keyword:
type: string
title: Filter the search by os_info.os_architecture.keyword. Search for the matches that contain the value
not.os_info.os_architecture:
type: string
title: Filter the search by not.os_info.os_architecture. Search for the matches that are not equal to the value
not.os_info.os_architecture.keyword:
type: string
title: Filter the search by not.os_info.os_architecture.keyword. Search for the matches that do not contain the value
os_info.os_release_name:
type: string
title: Filter the search by os_info.os_release_name. Search for an exact match
os_info.os_release_name.keyword:
type: string
title: Filter the search by os_info.os_release_name.keyword. Search for the matches that contain the value
not.os_info.os_release_name:
type: string
title: Filter the search by not.os_info.os_release_name. Search for the matches that are not equal to the value
not.os_info.os_release_name.keyword:
type: string
title: Filter the search by not.os_info.os_release_name.keyword. Search for the matches that do not contain the value
cve_id:
type: string
title: Filter the search by cve_id. Search for an exact match
cve_id.keyword:
type: string
title: Filter the search by cve_id.keyword. Search for the matches that contain the value
not.cve_id:
type: string
title: Filter the search by not.cve_id. Search for the matches that are not equal to the value
not.cve_id.keyword:
type: string
title: Filter the search by not.cve_id.keyword. Search for the matches that do not contain the value
severity:
type: string
title: Filter the search by severity. Search for an exact match
severity.keyword:
type: string
title: Filter the search by severity.keyword. Search for the matches that contain the value
not.severity:
type: string
title: Filter the search by not.severity. Search for the matches that are not equal to the value
not.severity.keyword:
type: string
title: Filter the search by not.severity.keyword. Search for the matches that do not contain the value
document_id:
type: string
title: Filter with document_id
document_id.keyword:
type: string
title: Filter with document_id.keyword
not.document_id:
type: array
title: Filter the search by not.document_id. Search for the matches that are not equal to the value
cisa_exploitable:
type: boolean
title: Filter the search by cisa_exploitable. Search for an exact match
known_ransomware_campaign_use:
type: boolean
title: Filter the search by known_ransomware_campaign_use. Search for an exact match
severity_score:
type: number
title: Filter the search by severity_score. Search for an exact match
severity_score_lt:
type: number
title: Filter the search by severity_score_lt. Search for the documents that are less than the value
severity_score_lte:
type: number
title: Filter the search by severity_score_lte. Search for the documents that are less than the value
severity_score_gt:
type: number
title: Filter the search by severity_score_gt. Search for the documents that are greater than the value
severity_score_gte:
type: number
title: Filter the search by severity_score_gte. Search for the documents that are greater than the value
installation_date_before:
type: string
format: date-time
title: Filter the search by installation_date_before. Search for an exact match
installation_date_after:
type: string
# --- truncated at 32 KB (573 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/malwarebytes/refs/heads/main/openapi/malwarebytes-vulnerability-management-api-openapi.yml