Get all devices

Returns all devices for the authenticated organization from FleetDM. Supports both API key authentication (X-API-Key header) and session authentication (cookies + X-Organization-Id header).

GET /v1/devices

Try it

Get all devices

cURL

curl --request GET \
  --url http://localhost:3333/v1/devices \
  --header 'X-API-Key: <api-key>'

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": 25,
  "authType": "api-key",
  "authenticatedUser": {
    "id": "usr_abc123def456",
    "email": "[e-mail]"
  }
}

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

200

application/json

Devices retrieved successfully

data · object[]

Show child attributes

data. created_at · string · required

Device created at

Example:

"2024-01-01T00:00:00Z"

data. updated_at · string · required

Device updated at

Example:

"2024-01-15T00:00:00Z"

data. software · object[] · required

Software list

data. software_updated_at · string · required

Software updated at

Example:

"2024-01-10T00:00:00Z"

data. id · number · required

Device ID

Example:

123

data. detail_updated_at · string · required

Detail updated at

Example:

"2024-01-10T00:00:00Z"

data. label_updated_at · string · required

Label updated at

Example:

"2024-01-10T00:00:00Z"

data. policy_updated_at · string · required

Policy updated at

Example:

"2024-01-10T00:00:00Z"

data. last_enrolled_at · string · required

Last enrolled at

Example:

"2024-01-01T00:00:00Z"

data. seen_time · string · required

Last seen time

Example:

"2024-01-15T12:00:00Z"

data. refetch_requested · boolean · required

Refetch requested

Example:

false

data. hostname · string · required

Hostname

Example:

"johns-macbook"

data. uuid · string · required

Device UUID

Example:

"abc123def456"

data. platform · string · required

Platform

Example:

"darwin"

data. osquery_version · string · required

Osquery version

Example:

"5.10.2"

data. orbit_version · string · required

Orbit version

Example:

"1.19.0"

data. fleet_desktop_version · string · required

Fleet desktop version

Example:

"1.19.0"

data. scripts_enabled · boolean · required

Scripts enabled

Example:

true

data. os_version · string · required

OS version

Example:

"macOS 14.2.1"

data. build · string · required

Build

Example:

"23C71"

data. platform_like · string · required

Platform like

Example:

"darwin"

data. code_name · string · required

Code name

Example:

"sonoma"

data. uptime · number · required

Uptime in seconds

Example:

86400

data. memory · number · required

Memory in bytes

Example:

17179869184

data. cpu_type · string · required

CPU type

Example:

"x86_64"

data. cpu_subtype · string · required

CPU subtype

Example:

"x86_64h"

data. cpu_brand · string · required

CPU brand

Example:

"Intel(R) Core(TM) i7-9750H"

data. cpu_physical_cores · number · required

CPU physical cores

Example:

6

data. cpu_logical_cores · number · required

CPU logical cores

Example:

12

data. hardware_vendor · string · required

Hardware vendor

Example:

"Apple Inc."

data. hardware_model · string · required

Hardware model

Example:

"MacBookPro16,1"

data. hardware_version · string · required

Hardware version

Example:

"1.0"

data. hardware_serial · string · required

Hardware serial

Example:

"C02XW0AAJGH6"

data. computer_name · string · required

Computer name

Example:

"John's MacBook Pro"

data. public_ip · string · required

Public IP

Example:

"203.0.113.1"

data. primary_ip · string · required

Primary IP

Example:

"192.168.1.100"

data. primary_mac · string · required

Primary MAC

Example:

"00:11:22:33:44:55"

data. distributed_interval · number · required

Distributed interval

Example:

10

data. config_tls_refresh · number · required

Config TLS refresh

Example:

3600

data. logger_tls_period · number · required

Logger TLS period

Example:

300

data. team_id · object · required

Team ID

Example:

1

data. pack_stats · object[] · required

Pack stats

data. team_name · object · required

Team name

Example:

"Engineering"

data. users · object[] · required

Users

data. gigs_disk_space_available · number · required

Disk space available in GB

Example:

250.5

data. percent_disk_space_available · number · required

Percent disk space available

Example:

75.2

data. gigs_total_disk_space · number · required

Total disk space in GB

Example:

500

data. disk_encryption_enabled · boolean · required

Disk encryption enabled

Example:

true

data. issues · object · required

Issues

data. mdm · object · required

MDM info

data. refetch_critical_queries_until · object · required

Refetch critical queries until

Example:

"2024-01-20T00:00:00Z"

data. last_restarted_at · string · required

Last restarted at

Example:

"2024-01-10T08:00:00Z"

data. policies · object[] · required

Policies

Show child attributes

data.policies. id · number · required

Policy ID

Example:

123

data.policies. name · string · required

Policy name

Example:

"Password Policy"

data.policies. query · string · required

Policy query

Example:

"SELECT * FROM users;"

data.policies. critical · boolean · required

Whether policy is critical

Example:

true

data.policies. description · string · required

Policy description

Example:

"Ensures strong passwords"

data.policies. author_id · number · required

Author ID

Example:

456

data.policies. author_name · string · required

Author name

Example:

"John Doe"

data.policies. author_email · string · required

Author email

Example:

"[e-mail]"

data.policies. team_id · object · required

Team ID

Example:

789

data.policies. resolution · string · required

Policy resolution

Example:

"Update password settings"

data.policies. platform · string · required

Platform

Example:

"darwin"

data.policies. calendar_events_enabled · boolean · required

Calendar events enabled

Example:

false

data.policies. created_at · string · required

Created at

Example:

"2024-01-01T00:00:00Z"

data.policies. updated_at · string · required

Updated at

Example:

"2024-01-15T00:00:00Z"

data.policies. response · string · required

Policy response

Example:

"compliant"

data. labels · object[] · required

Labels

data. packs · object[] · required

Packs

data. batteries · object[] · required

Batteries

data. end_users · object[] · required

End users

data. last_mdm_enrolled_at · string · required

Last MDM enrolled at

Example:

"2024-01-01T00:00:00Z"

data. last_mdm_checked_in_at · string · required

Last MDM checked in at

Example:

"2024-01-15T12:00:00Z"

data. status · string · required

Device status

Example:

"online"

data. display_text · string · required

Display text

Example:

"Johns MacBook Pro"

data. display_name · string · required

Display name

Example:

"John's MacBook Pro"

count · number

Total number of devices

Example:

25

authType · enum<string>

How the request was authenticated

Available options: api-key, session

authenticatedUser · object

Show child attributes

authenticatedUser. id · string

User ID

Example:

"usr_abc123def456"

authenticatedUser. email · string

User email

Example:

"[e-mail]"