Rippling: List devices — response body — results item

API reference · Contract 2026-10-28

SDK schema: List devices — response body — results item

Field	Type	Presence	Description and constraints
$	object	Root
created_at	string	Required within parent	Record creation date
enrollment_status	string	Optional	The MDM enrollment status: ENROLLED, UNENROLLED, WAITING_FOR_CONNECTION, ERROR, etc. Known values: ENROLLED, WAITING_FOR_CONNECTION, ERROR, UNENROLLED
id	string	Required within parent	Identifier field
is_encrypted	boolean	Optional	Whether the device’s disk is encrypted (FileVault on macOS, BitLocker on Windows).
is_managed	boolean	Optional	Whether the device is managed via MDM.
last_checkin_at	string	Optional	When the Rippling agent last checked in from this device.
last_mdm_sync_at	string	Optional	When the device last synced with MDM.
lifecycle_state	string	Optional	The device lifecycle state (e.g. ACTIVE, READY, LOCKED, LOST, DECOMMISSIONED). Known values: INIT, ACTIVE, ACTIVATING, LOCKED, LOCKING, INACTIVE, PENDING_MDM, CLEANING, READY, DECOMMISSIONING, DECOMMISSIONED, FULL_WIPING, FULL_WIPED, E_CYCLED, MDM_LOCKED, LOST, LOST_PLAYING_SOUND
mdm_provider	string	Optional	The MDM provider currently recorded on the device (RIPPLING, JAMFCLOUD, INTUNE, KANDJI, etc.). Null when the device is not currently MDM-managed (typical for unenrolled or recently-reset devices). Known values: RIPPLING, JUMPCLOUD, JAMFCLOUD, FLEETSMITH, HEXNODE, MICROMDM, MERAKI, SOTI, ADDIGY, FLEETDM, KANDJI, ZOHO, INTUNE, OTHER
model	string	Optional	The device hardware model identifier as reported by MDM (e.g. ‘MacBookPro18,3’, ‘iPhone15,2’).
os_name	string	Optional	The device operating system name.
os_version	string	Optional	The device operating system version.
pending_actions	array	Optional	Actions currently queued against the device (not yet completed). Expandable. Expandable field
pending_actions[]	Model	Each item	Expand Retrieve a specific device — response body — pending actions item
pending_actions_id	array	Optional	The IDs of actions currently queued against the device (not yet completed).
pending_actions_id[]	string	Each item
platform	string	Optional	The OS platform the device runs: MACOS, WINDOWS, IOS, or IPADOS. Known values: MACOS, WINDOWS, IOS, IPADOS
serial_number	string	Optional	The device’s hardware serial number.
updated_at	string	Required within parent	Record update date
worker	Model	Optional	Expand Retrieve a specific device — response body — worker
worker_id	string	Optional	The ID of the worker this device is currently assigned to. Null if unassigned.

Referenced models: Retrieve a specific device — response body — pending actions item, Retrieve a specific device — response body — worker