Skip to main content
GET
/
v1
/
devices
Get all devices
curl --request GET \
  --url http://localhost:3333/v1/devices \
  --header 'X-API-Key: <api-key>'
{
  "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": "john@example.com",
          "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",
      "source": "fleet"
    }
  ],
  "count": 25,
  "authenticatedUser": {
    "id": "usr_abc123def456",
    "email": "user@company.com"
  }
}

Documentation Index

Fetch the complete documentation index at: https://bubbaaiinc-lewis-comp-company-tasks.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Headers

​
X-Organization-Id
string

Organization ID (required for session auth, optional for API key auth)

Response

Devices retrieved successfully

​
data
object[]
​
count
number

Total number of devices

Example:

25

​
authType
enum<string>

How the request was authenticated

Available options:
api-key,
session
​
authenticatedUser
object