v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
device_Device

Get all devices in the tenant

Retrieves a paginated list of all devices enrolled in the tenant across every supported platform.

Returns Android, Apple, Linux, and Windows devices in a single unified list, with extensive filtering by platform, OS version, group, blueprint assignment, connectivity, and more.

About Get All Devices

This is the multi-platform device list, returning an AndroidDevice, AppleDevice, LinuxDevice, or WindowsDevice object depending on each device's platform. It's the standard starting point for fleet-wide device inventory, auditing, and for finding device IDs to use in commands, operations, and Converge actions.

Key Fields / Query Parameters

platform — filters by ANDROID, APPLE, LINUX, or WINDOWS

group_multi — filters by one or more group IDs, including their subgroups

assigned_blueprint_id / current_blueprint_id — filters by the blueprint a device is assigned to versus the one it's currently converged to, useful for finding devices that haven't yet converged to a newly assigned blueprint

search — free-text search that covers name, serial, IMEI, and model across platforms, plus platform-specific fields such as udid for Apple devices

state — filters by device enrollment state

Common Use Cases

Building a fleet inventory view across all platforms

Finding every device that hasn't yet converged to a newly assigned blueprint by comparing assigned_blueprint_id and current_blueprint_id

Scoping a bulk operation to a specific group before issuing a Converge or command request

Best Practices

Use group_multi or platform filters to scope results before paging through very large fleets

Compare assigned_blueprint_id against current_blueprint_version_id_net to catch devices that are out of sync with their intended configuration

Paginate with limit and offset rather than fetching the full fleet in one call for enterprises with large device counts

Workflow

Call this endpoint with the filters that scope the device set you need

Page through results using limit and offset

Use the returned device id values as targets for commands, operations, or Converge actions

get/device/v0/devices/

Query parameters

limitinteger
offsetinteger
ordering'alias' | 'created_at' | 'last_seen' | 'model' | 'os_version' | 'name' | 'onboarded_on' | 'serial' | 'provisioned_on' | 'battery_level' | 'dpc_version' | 'eea_version' | 'is_gms' | 'security_state' | 'wifi_ssid' | 'platform' | 'template_name'

Field to order the results by. Prefix with '-' to reverse the order.

serialstring
udidstring
android_versionstring
ios_versionstring
ipados_versionstring
tvos_versionstring
windows_versionstring
stateinteger
battery_level_gtestring
battery_level_ltestring
is_gmsboolean
active_connectionstring
group_multistring uuid

Filter by multiple group ID. Fetch the devices from groups matching with the IDs and its subgroup.

group_multi_immediatestring uuid

Filter by multiple group IDs. Fetch the devices from groups matching with the IDs. Excludes devices in any subgroups.

assigned_blueprint_idstring uuid
current_blueprint_idstring uuid
current_blueprint_version_idstring uuid
current_blueprint_version_id_netstring uuid
platform'ANDROID' | 'APPLE' | 'LINUX' | 'WINDOWS'
os'iOS' | 'iPadOS' | 'tvOS' | 'Android' | 'Linux' | 'Windows'
device_sourcestring

a csv list of device sources [ABM, NON_ABM]

tagsstring

a csv list of tag UUID's

searchstring

Search devices by multiOS -> name, serial, imei, model. Apple -> udid. Android -> iccid, phone number, brand, wifi, manufacturer, hardware

foundation_device_model_idstring uuid
android_version_exactstring
foundation_major_versioninteger
foundation_minor_versioninteger
foundation_build_numberinteger
airwave_tenant_model_idstring
airwave_build_idstring
airwave_build_numberinteger
is_seamlessboolean
global_device_idstring

Response

Device information for the Tenant

codeinteger
messagestring