Method: enterprises.list

  • Lists EMM-managed enterprises, returning only basic fields like name and display name.

  • Requires the https://www.googleapis.com/auth/androidmanagement OAuth scope for authorization.

  • Allows filtering by Cloud project ID and pagination for large result sets.

  • Request body should be empty, and the response includes a list of enterprises and a token for pagination.

  • Uses a GET request to the https://androidmanagement.googleapis.com/v1/enterprises endpoint.

Lists EMM-managed enterprises. Only BASIC fields are returned.

HTTP request

GET https://androidmanagement.googleapis.com/v1/enterprises

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
projectId

string

Required. The Cloud project ID of the EMM managing the enterprises.
pageSize

integer

The requested page size. The actual page size may be fixed to a min or max value.
pageToken

string

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

enum (EnterpriseView)

Specifies which Enterprise fields to return. This method only supports BASIC.

Request body

The request body must be empty.

Response body

Response to a request to list enterprises.

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

JSON representation 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Fields
enterprises[]

object (Enterprise)

The list of enterprises.
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.

EnterpriseView

Specifies which Enterprise fields to return.

Enums
ENTERPRISE_VIEW_UNSPECIFIED The API will default to the BASIC view for the List method.
BASIC Includes name and enterpriseDisplayName fields.