# Fetch all devices in an enterprise

Returns a list of devices

Endpoint: GET /enterprise/{enterprise_id}/device/
Version: 1.0.0
Security: apiKey

## Path parameters:

  - `enterprise_id` (string, required)
    ID of the enterprise

## Query parameters:

  - `name` (string)
    filter by device name

  - `group` (string)
    filter by group id. It will list all the devices under this gorup including the subgroups

  - `imei` (string)
    filter by imei

  - `serial` (string)
    filter by serial number

  - `state` (integer)
    Following are the Device States and their description


* 0 = Device State is Unspecified
* 1 = Online
* 20 = Disabled (device has been factory reset or removed from the Esper Dashboard)
* 30 = Beginning Provisioning
* 40 = Configuring Google Play (still provisioning)
* 50 = Applying Policies and Installing Applications (still provisioning)
* 60 = Offline
* 70 = Device is undergoing a Factory Reset (reset started from Dashboard)
* 80 = Device Onboarding in Progress
* 90 = Device Onboarding Failed
* 100 = Device Onboarded in Esper
* 110 = Android For Work Account added
* 120 = Apps installed
* 130 = Branding Processed
* 140 = Permission Policy Processed
* 150 = Device Policy Processed
* 160 = Device Settings Processed
* 170 = Security Policy Processed
* 180 = Phone Policy Processed
* 190 = Custom Settings Processed
* 200 = Registered
    Enum: 0, 1, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180, 190, 200

  - `brand` (string)
    filter by brand

  - `is_gms` (boolean)
    filter for gms devices

  - `search` (string)
    A search term. Search by device name, imei or mac address

  - `tags` (string)
    A partial text search for device tags

  - `assigned_blueprint_id` (string)
    Filter by assigned blueprint id

  - `current_blueprint_id` (string)
    Filter by current blueprint id

  - `current_blueprint_version_id` (string)
    Filter by current blueprint version id

  - `limit` (integer)
    Number of results to return per page.

  - `offset` (integer)
    Return results from this index.

## Response 200 fields (application/json):

  - `count` (integer)

  - `next` (string)

  - `previous` (string)

  - `results` (array)

  - `results.id` (string)

  - `results.url` (string)

  - `results.device_name` (string)

  - `results.alias_name` (string)
    Device friendly name

  - `results.policy_name` (string)

  - `results.status` (integer)
    Current status of device

  - `results.state` (integer)
    Following are the Device States and their description


* 0 = Device State is Unspecified
* 1 = Online
* 20 = Disabled (device has been factory reset or removed from the Esper Dashboard)
* 30 = Beginning Provisioning
* 40 = Configuring Google Play (still provisioning)
* 50 = Applying Policies and Installing Applications (still provisioning)
* 60 = Offline
* 70 = Device is undergoing a Factory Reset (reset started from Dashboard)
* 80 = Device Onboarding in Progress
* 90 = Device Onboarding Failed
* 100 = Device Onboarded in Esper
* 110 = Android For Work Account added
* 120 = Apps installed
* 130 = Branding Processed
* 140 = Permission Policy Processed
* 150 = Device Policy Processed
* 160 = Device Settings Processed
* 170 = Security Policy Processed
* 180 = Phone Policy Processed
* 190 = Custom Settings Processed
* 200 = Registered
    Enum: 0, 1, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180, 190, 200

  - `results.current_command` (string)
    Current command associated with device

  - `results.suid` (string)
    Device generated unique id

  - `results.directory_record_id` (string)
    ID of Directory Record associated with the device (if available)

  - `results.fcm_id` (string)

  - `results.enterprise` (string)

  - `results.policy` (string)

  - `results.user` (string)

  - `results.groups` (array)

  - `results.tags` (array)

  - `results.api_level` (integer)

  - `results.template_name` (string)

  - `results.mqtt_id` (string)

  - `results.softwareInfo` (object)

  - `results.hardwareInfo` (object)

  - `results.displays` (object)

  - `results.networkInfo` (object)

  - `results.memoryInfo` (object)

  - `results.esper_cient` (string)

  - `results.device_type` (string)

  - `results.audioConstraints` (object)

  - `results.provisioned_on` (string)

  - `results.created_on` (string)

  - `results.current_app_mode` (integer)

  - `results.kiosk_app_name` (string)

  - `results.lockdown_state` (integer)

  - `results.timezone_string` (string)

  - `results.initialtemplate` (string)

  - `results.updated_on` (string)

  - `results.emm_device` (object)

  - `results.emm_device.google_device_id` (string)

  - `results.emm_device.managementType` (string)

  - `results.emm_device.device` (string)

  - `results.emm_device.google_user` (integer)

  - `results.emm_device.is_active` (boolean)

  - `results.is_gms` (boolean)

  - `results.has_seamlessInfo` (boolean)

## Response 401 fields (application/json):

  - `errors` (array)

  - `message` (string)

  - `status` (integer)

## Response 404 fields (application/json):

  - `errors` (array)

  - `message` (string)

  - `status` (integer)

## Response 500 fields (application/json):

  - `errors` (array)

  - `message` (string)

  - `status` (integer)