Get devices by member ID | Comp AI API

Returns all devices assigned to a specific member within the authenticated organization. Devices are fetched from FleetDM using the member’s dedicated.

GET /v1/devices/member/{memberId}

Get devices by member ID

cURL

curl --request GET \
  --url https://api.trycomp.ai/v1/devices/member/{memberId} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.trycomp.ai/v1/devices/member/{memberId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/devices/member/{memberId}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "data": [
    {
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T00:00:00Z",
      "software": [
        {}
      ],
      "software_updated_at": "2024-01-10T00:00:00Z",
      "id": 123,
      "detail_updated_at": "2024-01-10T00:00:00Z",
      "label_updated_at": "2024-01-10T00:00:00Z",
      "policy_updated_at": "2024-01-10T00:00:00Z",
      "last_enrolled_at": "2024-01-01T00:00:00Z",
      "seen_time": "2024-01-15T12:00:00Z",
      "refetch_requested": false,
      "hostname": "johns-macbook",
      "uuid": "abc123def456",
      "platform": "darwin",
      "osquery_version": "5.10.2",
      "orbit_version": "1.19.0",
      "fleet_desktop_version": "1.19.0",
      "scripts_enabled": true,
      "os_version": "macOS 14.2.1",
      "build": "23C71",
      "platform_like": "darwin",
      "code_name": "sonoma",
      "uptime": 86400,
      "memory": 17179869184,
      "cpu_type": "x86_64",
      "cpu_subtype": "x86_64h",
      "cpu_brand": "Intel(R) Core(TM) i7-9750H",
      "cpu_physical_cores": 6,
      "cpu_logical_cores": 12,
      "hardware_vendor": "Apple Inc.",
      "hardware_model": "MacBookPro16,1",
      "hardware_version": "1.0",
      "hardware_serial": "C02XW0AAJGH6",
      "computer_name": "John's MacBook Pro",
      "public_ip": "203.0.113.1",
      "primary_ip": "192.168.1.100",
      "primary_mac": "00:11:22:33:44:55",
      "distributed_interval": 10,
      "config_tls_refresh": 3600,
      "logger_tls_period": 300,
      "team_id": 1,
      "pack_stats": [
        {}
      ],
      "team_name": "Engineering",
      "users": [
        {}
      ],
      "gigs_disk_space_available": 250.5,
      "percent_disk_space_available": 75.2,
      "gigs_total_disk_space": 500,
      "disk_encryption_enabled": true,
      "issues": {},
      "mdm": {},
      "refetch_critical_queries_until": "2024-01-20T00:00:00Z",
      "last_restarted_at": "2024-01-10T08:00:00Z",
      "policies": [
        {
          "id": 123,
          "name": "Password Policy",
          "query": "SELECT * FROM users;",
          "critical": true,
          "description": "Ensures strong passwords",
          "author_id": 456,
          "author_name": "John Doe",
          "author_email": "[e-mail]",
          "team_id": 789,
          "resolution": "Update password settings",
          "platform": "darwin",
          "calendar_events_enabled": false,
          "created_at": "2024-01-01T00:00:00Z",
          "updated_at": "2024-01-15T00:00:00Z",
          "response": "compliant"
        }
      ],
      "labels": [
        {}
      ],
      "packs": [
        {}
      ],
      "batteries": [
        {}
      ],
      "end_users": [
        {}
      ],
      "last_mdm_enrolled_at": "2024-01-01T00:00:00Z",
      "last_mdm_checked_in_at": "2024-01-15T12:00:00Z",
      "status": "online",
      "display_text": "Johns MacBook Pro",
      "display_name": "John's MacBook Pro"
    }
  ],
  "count": 3,
  "member": {
    "id": "mem_abc123def456",
    "userId": "usr_abc123def456",
    "role": "admin",
    "department": "engineering",
    "isActive": true,
    "fleetDmLabelId": 123,
    "organizationId": "org_abc123def456",
    "createdAt": "2024-01-01T00:00:00Z"
  },
  "authType": "api-key",
  "authenticatedUser": {
    "id": "usr_abc123def456",
    "email": "[e-mail]"
  }
}

{
  "message": "Unauthorized"
}

{
  "message": "Member with ID mem_abc123def456 not found in organization org_abc123def456"
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Path Parameters

memberId · string · required

Member ID to get devices for

Example:

"mem_abc123def456"

Response

200

application/json

Member devices retrieved successfully

data · object[] · required

Array of devices assigned to the member

Show child attributes

count · number · required

Total number of devices for this member

Example:

3

member · object · required

Member information

Show child attributes

authType · enum<string> · required

How the request was authenticated

Available options: api-key, session

Example:

"api-key"

authenticatedUser · object

Authenticated user information (present for session auth)

Example:

{
  "id": "usr_abc123def456",
  "email": "[e-mail]"
}