Device Information

Use to retrieve device information.

API URL

Key	Datatype	Parameter Type	Required	Description	Default
access_token	string	URL	Yes	access token which archived from OAuth authentication step
opt	int	Body	Optional	Specify a type of the ids parameter 0: Device ID or Mac Address 1: 3rd party custom ID which is linked with a device
ids	string	Body	Yes	ID of a device. It can be Device ID or Device MAC address or a custom ID 0: Device ID or MAC Address 1: 3rd party custom ID which is linked with a device
select	object	Body	Optional	select data to return in response data
select.categories	array<string>	Body	Optional	Specify categories which are returned in response. If this is not defined or empty, all categories applied for a device will be returned Values can be "vulnerabilities", "patch_management", "anti-malware", "encryption", "user_authentication", "anti-phishing", "backup", "firewall", "hard_drive", "operating_system", "threats", "repeated_threats", "suspicious_ips", "custom_check", "instant_messenger", "cleaner_optimizer", "developer_tool", "cloud_storage", "public_file_sharing", "remote_control", "recording_web_meeting", "uninstaller", "toolbars", "media_player", "vpn_client", "unclassified_pua", "system_security"	empty

Key	Datatype	Description
device_id	string	Device ID which MetaDefender IT-OT Access generates unique for a device
status	string	status of device. Values are: compliant: device is in compliance with a policy which the device is assigned to on your account non-compliant: device is not in compliance with a policy which the device is assigned to on your account exempted: device is exempted out_of_license_usage: device is out of token usage. unknown: device is not installed MetaDefender IT-OT Access agent ignored: device is not installed MetaDefender IT-OT Access agent and ignored by an administrator deleted: device is deleted not-found: device is not found
severity	string	Severity level. Values are critical: device has critical issues warning: device has warning issues no-issues: device doesn't have any issues
device_name	string	Hostname of the device. It will get "<private>" value if it's a non-collectible to each fields which related to privacy.
categories	array<object>	Details of each posture category
categories.id	string	Category ID. See available values if the description of the parameter " select.categories" in the request parameters.
categories.severity	int	Values are: -1: this category is disabled on a policy 0: no issues found in this category 1: found warning issues in this category 2: found critical issues in this category

Example Request

Description: get device information and only want to get information about the "encryption" category in the response.

Example Request

Description: get device information with device deleted and device not-found in the response.

Example Request

Description: get device information and include all categories information in the response.

Last updated on

Was this page helpful?