Optional.Resource nameof the customer in the format:customers/{customer}, where customer is the customer to whom the device belongs. If you're using this API for your own organization, usecustomers/my_customer. If you're using this API to manage another organization, usecustomers/{customer}, where customer is the customer to whom the device belongs.
filter
string
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 at the end 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). This includes devices that may be unassigned or assigned to users.
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 page details how to list and search devices using the \u003ccode\u003eGET https://cloudidentity.googleapis.com/v1/devices\u003c/code\u003e HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request supports optional query parameters such as \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 device list.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a JSON object containing an array of \u003ccode\u003edevices\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eview\u003c/code\u003e parameter allows to specify whether to return all devices imported by the admin (\u003ccode\u003eCOMPANY_INVENTORY\u003c/code\u003e), or only devices with at least one user registered on them (\u003ccode\u003eUSER_ASSIGNED_DEVICES\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eAccess to this API requires one of the following OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices.readonly\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: devices.list\n\nLists/Searches devices.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/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."]]
