Method: enterprises.list

  • This document details the HTTP request, query parameters, request body, and response body for listing EMM-managed enterprises.

  • The HTTP request uses a GET method to https://androidmanagement.googleapis.com/v1/enterprises.

  • Query parameters include projectId (required), pageSize, pageToken, and view, which is limited to BASIC.

  • The request body must be empty, and the successful response body contains a list of enterprises and a nextPageToken.

  • Authorization requires the https://www.googleapis.com/auth/androidmanagement OAuth scope.

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.