Optional. Additional restrictions when fetching list of devices. For a list of search fields, refer toMobile device search fields. Multiple search fields are separated by the space character.
pageSize
integer
Optional. The maximum number of Devices to return. If unspecified, at most 20 Devices will be returned. The maximum value is 100; values above 100 will be coerced to 100.
pageToken
string
Optional. A page token, received from a previousdevices.listcall. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided todevices.listmust match the call that provided the page token.
orderBy
string
Optional. Order specification for devices in the response. Only one of the following field names may be used to specify the order:createTime,lastSyncTime,model,osVersion,deviceTypeandserialNumber.descmay be specified optionally to specify results to be sorted in descending order. Default order is ascending.
The view determines which devices and device info are present in the response.
Enums
VIEW_UNSPECIFIED
Default value. The value is unused.
COMPANY_INVENTORY
This view contains all devices imported by the company admin. Each device in the response contains all information specified by the company admin when importing the device (i.e. asset tags).
USER_ASSIGNED_DEVICES
This view contains all devices with at least one user registered on the device. Each device in the response contains all device information, except for asset tags.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of devices using a GET request to \u003ccode\u003ehttps://cloudidentity.googleapis.com/v1beta1/devices\u003c/code\u003e, supporting gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request supports optional parameters including \u003ccode\u003ecustomer\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003eorderBy\u003c/code\u003e, and \u003ccode\u003eview\u003c/code\u003e to refine the list and manage pagination of the devices.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003edevices\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for pagination if there are more results, with each device containing details as defined in the Device resource.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices.readonly\u003c/code\u003e, and offers different \u003ccode\u003eview\u003c/code\u003e options like \u003ccode\u003eCOMPANY_INVENTORY\u003c/code\u003e and \u003ccode\u003eUSER_ASSIGNED_DEVICES\u003c/code\u003e to control the device information included in the response.\u003c/p\u003e\n"],["\u003cp\u003eThe maximum number of Devices returned in one page is 100, and if the \u003ccode\u003epageSize\u003c/code\u003e is above 100 it will be coerced to 100.\u003c/p\u003e\n"]]],[],null,["# Method: devices.list\n\nLists/Searches devices.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1beta1/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message that is returned from the devices.list method.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-identity.devices.readonly`\n- `https://www.googleapis.com/auth/cloud-identity.devices`\n- `https://www.googleapis.com/auth/cloud-identity`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nView\n----\n\nThe view determines which devices and device info are present in the response."]]
