Method: enterprises.devices.list

  • This document details how to list devices for a given enterprise using an HTTP GET request.

  • The request uses path parameters to specify the enterprise ID and can include query parameters for pagination.

  • The request body must be empty, and the response body contains a list of devices and a token for the next page of results if applicable.

  • The request requires thehttps://www.googleapis.com/auth/androidmanagement authorization scope.

Lists devices for a given enterprise. Deleted devices are not returned in the response.

HTTP request

GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the enterprise in the formenterprises/{enterpriseId}.

Query parameters

Parameters
pageSize

integer

The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time.

pageToken

string

A token identifying a page of results returned by the server.

Request body

The request body must be empty.

Response body

Response to a request to list devices for a given enterprise.

If successful, the response body contains data with the following structure:

JSON representation
{"devices":[{object (Device)}],"nextPageToken":string}
Fields
devices[]

object (Device)

The list of devices.

nextPageToken

string

If there are more results, a token to retrieve next page of results.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/androidmanagement

For more information, see theOAuth 2.0 Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-04 UTC.