GET
/
entities
/
devices
/
{device_id}
curl --request GET \
  --url https://api.leen.dev/v1/entities/devices/{device_id} \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-CONNECTION-ID: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "active",
  "platform": "mac",
  "hostnames": [
    "<string>"
  ],
  "os_version": "<string>",
  "os_major_version": "<string>",
  "os_minor_version": "<string>",
  "fqdns": [
    "<string>"
  ],
  "ipv4s": [
    "<string>"
  ],
  "ipv6s": [
    "<string>"
  ],
  "mac_addresses": [
    "<string>"
  ],
  "last_seen": "2023-11-07T05:31:56Z",
  "first_seen": "2023-11-07T05:31:56Z",
  "source_vendors": [
    {
      "vendor": "<string>",
      "vendor_id": "<string>",
      "agent_info": {
        "agent_version": "<string>",
        "signature_version": "<string>",
        "policies": [
          {}
        ]
      }
    }
  ],
  "installed_software": [
    "<string>"
  ],
  "ad_info": {
    "org_unit": "<string>",
    "site_name": "<string>",
    "domain": "<string>",
    "device_id": "<string>"
  },
  "cloud_metadata": {
    "cloud_provider": "aws",
    "account_id": "<string>",
    "region": "<string>",
    "availability_zone": "<string>",
    "instance_id": "<string>",
    "instance_type": "<string>",
    "image_id": "<string>",
    "kernel_id": "<string>",
    "vpc_id": "<string>",
    "subnet_id": "<string>"
  },
  "tags": [
    {
      "key": "<string>",
      "value": "<string>",
      "source": "aws"
    }
  ],
  "identities": [
    {
      "username": "<string>",
      "user_sid": "<string>"
    }
  ],
  "vendor_data": {}
}

Authorizations

​
X-CONNECTION-ID
string
header
required
​
X-API-KEY
string
header
required

Path Parameters

​
device_id
string
required

Response

200
application/json
Successful Response
​
id
string
required
​
status
enum<string>
required
Available options:
active,
offline,
quarantined
​
last_seen
string | null
required
​
first_seen
string | null
required
​
source_vendors
object[]
required
​
installed_software
string[] | null
required
​
ad_info
object | null
required
​
platform
enum<string> | null
Available options:
mac,
windows,
linux,
unknown
​
hostnames
string[] | null
​
os_version
string | null
​
os_major_version
string | null
​
os_minor_version
string | null
​
fqdns
string[] | null
​
ipv4s
string[] | null
​
ipv6s
string[] | null
​
mac_addresses
string[] | null
​
cloud_metadata
object | null

CloudMetadata, currently only AWS is supported

​
tags
object[] | null
​
identities
object[] | null
​
vendor_data
object | null

Vendor specific pass through data, values can vary based on vendor

List DevicesList Device Groups