Devices

Get a specific device by ID

get/organizations/{organizationId}/devices/{deviceId}

Request

  • Base URL: https://api.xfa.tech
  • URL: https://api.xfa.tech/organizations/{organizationId}/devices/{deviceId}
  • Auth: HTTP bearer

Path parameters

organizationIdstring required

ID of Organization

deviceIdstring required

ID of Device

Query parameters

policyIdstring

Policy ID for evaluation

add_cvesstring

Include CVE information

use_decisionsstring

Include evaluation decisions in the response

Response

Device found

admin_mfa_approval_status'PENDING' | 'APPROVED' | 'REJECTED'

Coarse administrator MFA approval badge visible only to Administrators.

device_idstring required

ID of the device

timestamp_submittedinteger required

Timestamp when the device was submitted (max of verified and discovery)

timestamp_submitted_verifiedinteger

Timestamp when the device was last submitted by the XFA agent (verified device)

timestamp_submitted_discoveryinteger

Timestamp when the device was last submitted by a discovery provider (Microsoft, Google, Okta, etc.)

os_namestring

Name of the operating system

os_versionstring

Version of the operating system

os_build_numberstring

Build number of the operating system (e.g. for iOS)

os_flavourstring

Flavour of the operating system

os_is_ltsboolean

Whether the operating system is a long-term-support release (Ubuntu LTS / ESM)

os_uptodateboolean

Whether the operating system is up to date

os_outdatedinteger

Days OS is outdated

os_rolling_release_last_full_updateinteger

Timestamp of the last full system update on a rolling-release distro (e.g. pacman -Syu on Arch Linux). Rolling releases are evaluated on update recency + local CVE audit rather than a version number, so os_version is not meaningful (it is typically "rolling").

os_rolling_release_has_security_risks_local_detectionboolean

Whether a local security audit tool (e.g. arch-audit) detected known package vulnerabilities on a rolling-release distro. Basis for the OS up-to-date decision on rolling releases.

os_evaluated_by_policyboolean

Whether the operating system is evaluated by policy

os_autoupdateboolean

Whether the operating system auto-updates

os_autoupdate_evaluated_by_policyboolean

Whether the operating system auto-update is evaluated by policy

android_security_levelstring

Android security level

manufacturerstring

Manufacturer of the device

modelstring

Model of the device

model_identifierstring

Identifier of the device model

browser_last_used'Chrome' | 'Chromium' | 'Firefox' | 'Safari' | 'Edge' | 'Brave' | 'Opera' | 'Vivaldi' | 'IE' | 'Arc'

Name of the browser last used

browser_uptodateboolean

Whether the browser is up to date

browser_evaluated_by_policyboolean

Whether the browser is evaluated by policy

chrome_versionstring

Version of Chrome browser

chrome_uptodateboolean

Whether Chrome is up to date

chrome_outdatedinteger

Days Chrome is outdated

chrome_safebrowsing_enabledboolean

Whether Chrome Safe Browsing is enabled

chrome_safebrowsing_evaluated_by_policyboolean

Whether Chrome Safe Browsing is evaluated by policy

chrome_safebrowsing_enhancedboolean

Whether Chrome Safe Browsing Enhanced is enabled

chrome_safebrowsing_enhanced_evaluated_by_policyboolean

Whether Chrome Safe Browsing Enhanced is evaluated by policy

chrome_do_not_trackboolean

Whether Chrome Do Not Track is enabled

chrome_do_not_track_evaluated_by_policyboolean

Whether Chrome Do Not Track is evaluated by policy

chrome_dns_over_httpsboolean

Whether Chrome DNS over HTTPS is enabled

chrome_dns_over_https_evaluated_by_policyboolean

Whether Chrome DNS over HTTPS is evaluated by policy

firefox_versionstring

Version of Firefox browser

firefox_uptodateboolean

Whether Firefox is up to date

firefox_outdatedinteger

Days Firefox is outdated

firefox_https_onlyboolean

Whether Firefox HTTPS Only mode is enabled

firefox_https_only_evaluated_by_policyboolean

Whether Firefox HTTPS Only mode is evaluated by policy

firefox_dns_over_httpsboolean

Whether Firefox DNS over HTTPS is enabled

firefox_dns_over_https_evaluated_by_policyboolean

Whether Firefox DNS over HTTPS is evaluated by policy

firefox_enhanced_tracking_protectionboolean

Whether Firefox Enhanced Tracking Protection is enabled

firefox_enhanced_tracking_protection_evaluated_by_policyboolean

Whether Firefox Enhanced Tracking Protection is evaluated by policy

firefox_enhanced_tracking_protection_strictboolean

Whether Firefox Enhanced Tracking Protection Strict mode is enabled

firefox_enhanced_tracking_protection_strict_evaluated_by_policyboolean

Whether Firefox Enhanced Tracking Protection Strict mode is evaluated by policy

edge_versionstring

Version of Edge browser

edge_uptodateboolean

Whether Edge is up to date

edge_outdatedinteger

Days Edge is outdated

safari_versionstring

Version of Safari browser

safari_uptodateboolean

Whether Safari is up to date

safari_outdatedinteger

Days Safari is outdated

brave_versionstring

Version of Brave browser

brave_uptodateboolean

Whether Brave is up to date

brave_outdatedinteger

Days Brave is outdated

arc_versionstring

Version of Arc browser

arc_uptodateboolean

Whether Arc is up to date

arc_outdatedinteger

Days Arc is outdated

opera_versionstring

Version of Opera browser

opera_uptodateboolean

Whether Opera is up to date

opera_outdatedinteger

Days Opera is outdated

vivaldi_versionstring

Version of Vivaldi browser

vivaldi_uptodateboolean

Whether Vivaldi is up to date

vivaldi_outdatedinteger

Days Vivaldi is outdated

diskencryption_supportedboolean

Whether disk encryption is supported

diskencryption_activeboolean

Whether disk encryption is active

diskencryption_evaluated_by_policyboolean

Whether disk encryption is evaluated by policy

antivirus_enabledboolean

Whether antivirus is enabled

antivirus_product_namestring

Name of the detected antivirus product

antivirus_installedboolean

Whether the antivirus product is installed

antivirus_runningboolean

Whether the antivirus product is running

antivirus_uptodateboolean

Whether the antivirus definitions are up to date

antivirus_inventory_status'complete' | 'partial' | 'unavailable'

Completeness of the latest native antivirus measurement.

antivirus_timestampinteger

Server timestamp of the antivirus measurement; unrelated device updates do not refresh it.

antivirus_source'xfa_agent' | 'browser' | 'chrome_device_trust' | 'edge_device_trust' | 'discovery'

Server-assigned source of the antivirus measurement.

antivirus_evaluated_by_policyboolean

Whether antivirus is evaluated by policy

firewall_enabledboolean

Whether firewall is enabled

firewall_evaluated_by_policyboolean

Whether firewall is evaluated by policy

find_my_device_enabledboolean

Whether Find My Device is enabled

find_my_device_evaluated_by_policyboolean

Whether Find My Device is evaluated by policy

vanta_client_runningboolean

Whether Vanta client is running

vanta_client_running_evaluated_by_policyboolean

Whether Vanta client running is evaluated by policy

aikido_safe_chain_supportedboolean

Whether Aikido Safe Chain is supported on this device's OS (cross-platform: mac/linux/windows)

aikido_safe_chain_installedboolean

Whether Aikido Safe Chain is installed on the device

aikido_safe_chain_activeboolean

Whether Aikido Safe Chain shell-profile integration is active (the wrapper is on PATH and intercepts package-manager calls)

aikido_safe_chain_versionstring

Installed version of Aikido Safe Chain (from safe-chain --version)

aikido_safe_chain_latest_versionstring

Latest known Aikido Safe Chain version (from xfa-versions-service)

aikido_safe_chain_uptodateboolean

Whether the installed Aikido Safe Chain version matches the latest known version

aikido_safe_chain_evaluated_by_policyboolean

Whether Aikido Safe Chain is evaluated by policy

aikido_endpoint_supportedboolean

Whether Aikido Endpoint is supported on this device's OS (macOS only today)

aikido_endpoint_installedboolean

Whether the Aikido Endpoint agent is installed on the device

aikido_endpoint_activeboolean

Whether the Aikido Endpoint system extension is active

aikido_endpoint_versionstring

Installed version of Aikido Endpoint (from the bundle's Info.plist)

aikido_endpoint_latest_versionstring

Latest known Aikido Endpoint version (from xfa-versions-service)

aikido_endpoint_uptodateboolean

Whether the installed Aikido Endpoint version matches the latest known version

aikido_endpoint_evaluated_by_policyboolean

Whether Aikido Endpoint is evaluated by policy

intune_enrolledboolean

Whether the device is enrolled in Intune

intune_tenant_idsstring[]

List of Intune tenant IDs

intune_evaluated_by_policyboolean

Whether Intune enrollment is evaluated by policy

sentinelone_installedboolean

Whether the SentinelOne EDR agent is installed on the device

sentinelone_management_urlstring

URL of the SentinelOne management console

sentinelone_site_namestring

Site name in the SentinelOne management console

sentinelone_evaluated_by_policyboolean

Whether SentinelOne installation is evaluated by policy

time_since_boot_in_daysinteger

Time since the device was last booted, in days

microsoft_word_versionstring

Version of Microsoft Word

microsoft_word_uptodateboolean

Whether Microsoft Word is up to date

microsoft_word_evaluated_by_policyboolean

Whether Microsoft Word is evaluated by policy

microsoft_excel_versionstring

Version of Microsoft Excel

microsoft_excel_uptodateboolean

Whether Microsoft Excel is up to date

microsoft_excel_evaluated_by_policyboolean

Whether Microsoft Excel is evaluated by policy

microsoft_powerpoint_versionstring

Version of Microsoft PowerPoint

microsoft_powerpoint_uptodateboolean

Whether Microsoft PowerPoint is up to date

microsoft_powerpoint_evaluated_by_policyboolean

Whether Microsoft PowerPoint is evaluated by policy

microsoft_outlook_versionstring

Version of Microsoft Outlook

microsoft_outlook_uptodateboolean

Whether Microsoft Outlook is up to date

microsoft_outlook_evaluated_by_policyboolean

Whether Microsoft Outlook is evaluated by policy

microsoft_teams_versionstring

Version of Microsoft Teams

microsoft_teams_uptodateboolean

Whether Microsoft Teams is up to date

microsoft_teams_evaluated_by_policyboolean

Whether Microsoft Teams is evaluated by policy

slack_versionstring

Version of Slack

slack_uptodateboolean

Whether Slack is up to date

slack_evaluated_by_policyboolean

Whether Slack is evaluated by policy

zoom_versionstring

Version of Zoom

zoom_uptodateboolean

Whether Zoom is up to date

zoom_evaluated_by_policyboolean

Whether Zoom is evaluated by policy

skype_versionstring

Version of Skype

skype_uptodateboolean

Whether Skype is up to date

skype_evaluated_by_policyboolean

Whether Skype is evaluated by policy

adobe_acrobat_reader_versionstring

Version of Adobe Acrobat Reader

adobe_acrobat_reader_uptodateboolean

Whether Adobe Acrobat Reader is up to date

adobe_acrobat_reader_evaluated_by_policyboolean

Whether Adobe Acrobat Reader is evaluated by policy

adobe_acrobat_standard_or_pro_versionstring

Version of Adobe Acrobat Standard or Pro

adobe_acrobat_standard_or_pro_uptodateboolean

Whether Adobe Acrobat Standard or Pro is up to date

adobe_acrobat_standard_or_pro_evaluated_by_policyboolean

Whether Adobe Acrobat Standard or Pro is evaluated by policy

foxit_reader_versionstring

Version of Foxit Reader

foxit_reader_uptodateboolean

Whether Foxit Reader is up to date

foxit_reader_evaluated_by_policyboolean

Whether Foxit Reader is evaluated by policy

sumatra_pdf_versionstring

Version of Sumatra PDF

sumatra_pdf_uptodateboolean

Whether Sumatra PDF is up to date

sumatra_pdf_evaluated_by_policyboolean

Whether Sumatra PDF is evaluated by policy

nitro_pdf_reader_versionstring

Version of Nitro PDF Reader

nitro_pdf_reader_uptodateboolean

Whether Nitro PDF Reader is up to date

nitro_pdf_reader_evaluated_by_policyboolean

Whether Nitro PDF Reader is evaluated by policy

jailbrokenboolean

Whether the device is jailbroken

jailbroken_evaluated_by_policyboolean

Whether the device being jailbroken is evaluated by policy

rootedboolean

Whether the device is rooted

rooted_evaluated_by_policyboolean

Whether the device being rooted is evaluated by policy

developer_modeboolean

Whether developer mode is enabled

developer_mode_evaluated_by_policyboolean

Whether developer mode is evaluated by policy

secure_boot_enabledboolean

Whether secure boot is enabled

secure_boot_enabled_evaluated_by_policyboolean

Whether secure boot is evaluated by policy

secure_boot_status'OK' | 'WARNING' | 'BLOCKING' | 'MISSING'

Security status indicating compliance level

remote_login_enabledboolean

Whether remote login is enabled

remote_login_enabled_evaluated_by_policyboolean

Whether remote login is evaluated by policy

remote_management_enabledboolean

Whether remote management is enabled

remote_management_enabled_evaluated_by_policyboolean

Whether remote management is evaluated by policy

screen_sharing_enabledboolean

Whether screen sharing is enabled

screen_sharing_enabled_evaluated_by_policyboolean

Whether screen sharing is evaluated by policy

remote_scripting_enabledboolean

Whether remote scripting is enabled

remote_scripting_enabled_evaluated_by_policyboolean

Whether remote scripting is evaluated by policy

unattended_remote_access_enabledboolean

Whether unattended remote access is enabled

unattended_remote_access_enabled_evaluated_by_policyboolean

Whether unattended remote access is evaluated by policy

integrity_protection_enabledboolean

Whether integrity protection is enabled

integrity_protection_enabled_evaluated_by_policyboolean

Whether integrity protection is evaluated by policy

integrity_protection_status'supported' | 'active' | 'inactive' | 'unknown'

Integrity protection status

dns_servers_evaluated_by_policyboolean

Whether DNS servers are evaluated by policy

dns_servers_compliantboolean

Whether DNS servers are compliant

dns_validation_mode'exact_match' | 'exact_with_extra' | 'contains'

DNS validation mode

dns_status'OK' | 'WARNING' | 'BLOCKING' | 'MISSING'

Security status indicating compliance level

has_recently_rebootedboolean

Whether device has recently rebooted

has_recently_rebooted_evaluated_by_policyboolean

Whether recent reboot is evaluated by policy

windows_recall_evaluated_by_policyboolean

Whether Windows Recall is evaluated by policy

xfa_version_evaluated_by_policyboolean

Whether XFA version is evaluated by policy

xfa_up_to_dateboolean

Whether XFA is up to date

xfa_outdatedinteger

Days XFA is outdated

passwordmanager_evaluated_by_policyboolean

Whether password manager is evaluated by policy

nativeclient_installedboolean

Whether native client is installed

nativeclient_evaluated_by_policyboolean

Whether native client installation is evaluated by policy

authentication_activeboolean

Whether authentication is active

authentication_evaluated_by_policyboolean

Whether authentication is evaluated by policy

biometricsstring

Biometrics information

biometrics_evaluated_by_policyboolean

Whether biometrics is evaluated by policy

unsigned_applications_evaluated_by_policyboolean

Whether unsigned applications are evaluated by policy

install_protection_evaluated_by_policyboolean

Whether install protection is evaluated by policy

blocklisted_applications_evaluated_by_policyboolean

Whether blocklisted applications are evaluated by policy

managedboolean

Whether the device is managed

xfa_versionstring

XFA version

connectboolean

Whether the device is connected

merged_device_idsstring[] required

List of merged device IDs

merged_into_device_idstring

ID of the device into which this device is merged

skipboolean

Whether the device is skipped

unsupportedboolean

Whether the device is unsupported

discoveredboolean

Whether the device is discovered

google_mobile_device_idsstring[] required

List of Google mobile device IDs

google_cloud_identity_device_idsstring[] required

List of Google Cloud Identity device IDs

microsoft_device_idsstring[] required

List of Microsoft device IDs

okta_discoveredboolean

Whether the device is discovered by Okta

details_hiddenboolean

Set on a discovered device whose details the organization's plan does not include (hide_discovered_device_details). The record carries identity only (no check results, decisions or CVEs), plus issues_count and risk. Opening the device returns 403 discovered_device_details_not_in_plan.

issues_countinteger

Number of policy checks failing on the device (warn or block). Only set when details_hidden is true.

risk'safe' | 'unsafe' | 'unknown' | 'safe_with_unknowns'

Overall risk of the device against the policy. Only set when details_hidden is true.

has_unknown_checks_required_by_policyboolean

Whether the device has unknown checks required by policy

has_unsafe_checks_evaluated_by_policyboolean

Whether the device has unsafe checks evaluated by policy

has_not_shared_checks_required_by_policyboolean

Whether the person does not share a check the policy warns or blocks on (XFA-3686). Such a device is not compliant. Absent when false or not yet evaluated.

timestamp_last_notifiedstring date-time

Timestamp when the device was last notified

browser_user_agentstring

User agent of the browser

emailstring

Email associated with the device

organization_idstring

ID of the organization

timestamp_discoveredinteger

Timestamp when the device was discovered

uuidstring

UUID of the device

notestring

Note added to the device/shadow

tagsstring[]

Tags associated with the device/shadow

snoozed_untilinteger

Absolute timestamp when the device stops being snoozed

snoozed_atinteger

Timestamp when snoozing started

snoozed_bystring

Email address of the admin who snoozed the device

snooze_reasonstring

Optional reason for the snooze

snooze_mfaboolean

Whether MFA prompts are also snoozed

Changes

No recorded changes to this operation across all 1 revision of this API.