Method: enterprises.devices.list
Stay organized with collections
Save and categorize content based on your preferences.
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 uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
The name of the enterprise in the form enterprises/{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 the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-04 UTC.
[null,null,["Last updated 2025-08-04 UTC."],[[["\u003cp\u003eLists all devices for a given enterprise, excluding deleted ones.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eGET\u003c/code\u003e request to the specified URL with \u003ccode\u003eenterpriseId\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving results.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of devices and a token for the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to list devices for an enterprise using a `GET` request to the specified URL. The request uses path parameter `parent` (enterprise name) and optional query parameters `pageSize` and `pageToken` for pagination. The request body should be empty. The successful response body contains a list of `devices` and a `nextPageToken` for retrieving subsequent pages. This process requires `https://www.googleapis.com/auth/androidmanagement` authorization scope.\n"],null,["# Method: enterprises.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists devices for a given enterprise. Deleted devices are not returned in the response.\n\n### HTTP request\n\n`GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------|\n| `parent` | `string` The name of the enterprise in the form `enterprises/{enterpriseId}`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n| `pageToken` | `string` A token identifying a page of results returned by the server. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a request to list devices for a given enterprise.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/android/management/reference/rest/v1/enterprises.devices#Device) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/android/management/reference/rest/v1/enterprises.devices#Device)`)` The list of devices. |\n| `nextPageToken` | `string` If there are more results, a token to retrieve next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
