ESesper
device_Device

Get all devices in the tenant

Changed on

Deprecated. Use Get all devices (v2) instead.

Retrieves a paginated list of all devices enrolled in the tenant across Android, Apple, Linux, and Windows.

About Get All Devices (Deprecated)

GET /v2/devices/ replaces this endpoint and is the recommended way to list devices. Build new integrations on v2, and move existing integrations off this endpoint.

get/device/v0/devices/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/device/v0/devices/
  • Auth
    HTTP bearer

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

Example response

{
  "content": {
    "results": [
      {
        "timezone_string": "America/Los_Angeles"
      }
    ]
  }
}

Changes

  • fa7b9b652fb2Revision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status