Skip to main content

Get Device Details per MAC Address

Get a list of device details for the device with the specified MAC address or, for a static IP device, the device with the specified static IP address.
Rate limiting: 60 times per minute

Query Parameters
  • customerid string required

    The customer ID to which the API call is directed

  • deviceid string required

    The MAC address of a device for which you want to get details. For a static IP device, the device ID is its static IP address.


Successful Response (We only show some important fields here.)

  • deviceid string

    The device ID, which IoT Security uses to identify and track a device

  • hostname string

    The device hostname

  • category string

    The category to which the device belongs

  • profile string

    The device profile assigned to the device

  • profile_type string

    The type of device profile, such as IoT or Non_IoT

  • profile_vertical string

    The industry vertical for the profile such as Medical, IT Devices, and Office

  • ip_address string

    The IP address of a device

  • mac_address string

    The MAC address of a device

  • risk_score integer

    The risk score of a device

  • risk_level string

    The risk level of a device. There are four: low, medium, high, and critical

  • last_activity date-time

    A UTC timestamp for the last detected device activity

  • confidence_score string

    The confidence score for device classification

  • subnet string

    The subnet to which the device is attached

  • number_of_critical_alerts integer

    The number of critical alerts for the device

  • number_of_warning_alerts integer

    The number of warning alerts for the device

  • number_of_caution_alerts integer

    The number of caution alerts for the device

  • number_of_info_alerts integer

    The number of info alerts for the device

  • allTags object[]

    An array of user-defined tags assigned to a device. Each item in the array consists of three attributes: tagType, tagValue, and tagId.

  • Array [
  • tagType string

    The key for a user-defined tag

  • tagValue string

    The value of the tag key for a user-defined tag

  • tagId string

    The ID of a user-defined tag

  • ]