# Get all devices in the tenant

Returns all the devices in the tenant

Endpoint: GET /v2/devices/
Version: 1.0.0
Security: apiKey

## Header parameters:

  - `X-Tenant-Id` (string, required)

  - `X-Caller-Id` (string, required)

  - `X-SCAPI-Private-URL` (string, required)

## Query parameters:

  - `limit` (integer)

  - `offset` (integer)

  - `ordering` (string)
    Field to order the results by. Prefix with '-' to reverse the order.
    Enum: "alias", "created_at", "last_seen", "model", "os_version", "name", "serial", "provisioned_on", "battery_level", "dpc_version", "eea_version", "is_gms", "security_state", "wifi_ssid", "platform", "template_name", "policy_name", "state"

  - `serial` (string)

  - `udid` (string)

  - `android_version` (string)

  - `ios_version` (string)

  - `ipados_version` (string)

  - `windows_version` (string)

  - `state` (string)

  - `battery_level_gte` (string)

  - `battery_level_lte` (string)

  - `is_gms` (boolean)

  - `active_connection` (string)

  - `group_multi` (string)
    Filter by multiple group ID. Fetch the devices from groups matching with the IDs and it's subgroup.

  - `group_multi_immediate` (string)
    Filter by multiple group IDs. Fetch the devices from groups matching with the IDs.

  - `assigned_blueprint_id` (string)

  - `current_blueprint_id` (string)

  - `current_blueprint_version_id` (string)

  - `current_blueprint_version_id_net` (string)

  - `platform` (string)
    a csv list of platforms [ANDROID, APPLE, LINUX, WINDOWS]

  - `os` (string)
    Enum: "iOS", "iPadOS", "Android", "Linux", "Windows"

  - `device_source` (string)
    a csv list of device sources [ABM, NON_ABM]

  - `managed_by` (string)
    Enum: "BLUEPRINT", "TEMPLATE"

  - `template_multi` (string)
    a csv list of template names

  - `policy_multi` (string)
    a csv list of policy names

  - `search` (string)
    Search devices by multiOS -> name, serial, imei, model. Apple -> udid. Android -> iccid, phone number, brand, wifi, manufacturer, hardware, wifi mac address, sim operator, network operator, ip address

  - `foundation_device_model_id` (string)

  - `android_version_exact` (string)

  - `foundation_major_version` (integer)

  - `foundation_minor_version` (integer)

  - `foundation_build_number` (integer)

  - `airwave_tenant_model_id` (string)

  - `airwave_build_id` (string)

  - `airwave_build_number` (integer)

  - `foundation_version` (string)
    Full foundation version string (either os_version.major.minor.build or eea_version)

  - `esper_agent_version_name` (string)
    Filter devices by Esper agent version name (DPC version)

  - `tags` (string)
    a csv list of tag ids

  - `is_locked_down` (boolean)

  - `global_device_id` (string)

## Response 200 fields (application/json):

  - `content` (object)

  - `content.count` (integer)

  - `content.previous` (string)

  - `content.next` (string)

  - `content.results` (array)

## Response 400 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)

## Response 401 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)

## Response 500 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)