Field reference

This document aggregates all field definitions used across AirDroid Business tools, serving as a unified reference.

1. SelectedColumns Available Fields

The SelectedColumns parameter specifies which device fields to return, reducing data volume and token consumption.

1.1 Core Fields (Recommended to Always Include)

1.2 Status Fields

1.3 Device Info Fields

1.4 Network Fields

1.5 Group and Tag Fields

1.6 Time Fields

1.7 Hardware Identifier Fields

1.8 Media Fields

1.9 Location Fields

1.10 Other Fields

1.11 Complete Field List

Note: Below is the full list of available SelectedColumns fields, aggregated from all DSL definitions.

abi, acc, account_id, am_state, android_id, app_version, app_version_open,
available_rom, battery, battery_health, battery_source, battery_temperature,
batterycharging, bind_date, bios_version, camera_type, camera_url, catch_log,
config_status, cpu_platform, cpu_usage, daemon_status, degree, deploy_type,
device_id, device_name, device_owner, device_type, emm_provider, eth_mac,
front_camera_url, front_degree, group_id, group_name, gsm, hdmi, height,
iccid1, iccid2, imei, imei2, imsi, imsi2, ip, last_connect_date, lat, lng,
lost_mode_status, mac, manu, map_type, model, network_type, note, online,
opengl, operator, os_version, phone_number1, phone_number2, picture_url,
platform_type, position_update_time, private_ip, process, register_origin,
rxtx, screen, screen_brightness, screen_list, sdk_api_level, signal_strength,
sleep_mode, snid, tags, update_camera_url_time, update_front_camera_url_time,
update_picture_time, update_unix, width, wifi

2. Keyword Filtering Fields

The Keyword parameter is used to filter devices. Its type is object (not string), and multiple conditions use AND logic.

Important: Keyword is an object type, not a string!

2.1 Supported Filter Fields (Get All Devices)

2.2 Supported Filter Fields (Report Actions)

For report actions (Get Average Screen Time, Get Data Usage Overview, etc.), the Keyword parameter supports fuzzy search across these fields:

2.3 Unsupported Filter Fields

2.4 Filter Syntax

Single-condition filter (object format):

{
  "Keyword": {"online": "Online"}
}

Multi-condition filter (AND logic):

{
  "Keyword": {
    "online": "Online",
    "group_name": "Chicago Warehouse",
    "platform_type": "Android"
  }
}

Note for Get All Devices: The Keyword parameter in Get All Devices only supports filtering by ONE field at a time. For multiple-field filtering with AND logic, use Get All Devices With Filter instead.

Filter devices in the default group:

{
  "Keyword": {"group_name": "default"}
}

3. Status Code Mapping Table

3.1 online - Online Status

3.2 platform_type - Platform Type

3.3 battery_source - Power Source

3.4 batterycharging - Charging Status

3.5 network_type - Network Type

3.6 signal_strength - Signal Strength

3.7 config_status - Configuration Status

3.8 daemon_status - Permission Status

3.9 am_state - Root Status

3.10 lost_mode_status - Lost Mode Status

3.11 deploy_type - Deployment Type

3.12 emm_provider - EMM Provider

3.13 device_type - Device Type

3.14 map_type - Map Type

3.15 is_default - Default Group Flag

4. Usage Recommendations

4.1 Performance Optimization

1. Always specify SelectedColumns: Avoid returning all fields to reduce data volume and token consumption
2. Recommended core fields: ["device_id", "device_name", "online", "battery", "group_name"]
3. Add fields on demand: Include additional fields based on your specific needs

4.2 Common Filter Combinations

Important: The output field online returns a number (1 or 0), but the Keyword filter value must be a string ("Online" or "Offline"). The same pattern applies to other status fields — always check the Keyword Filter Value column in the mapping tables above.