Method: organizations.apps.list

Lists IDs of apps within an organization that have the specified app status (approved or revoked) or are of the specified app type (developer or company).

HTTP request

GET https://apigee.googleapis.com/v1/{parent=organizations/*}/apps

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource path of the parent in the following format:organizations/{org}

Authorization requires the followingIAM permission on the specified resourceparent:

  • apigee.apps.list

Query parameters

Parameters
status

string

Optional. Filter by the status of the app. Valid values areapproved orrevoked. Defaults toapproved.

apptype

string

Optional. 'apptype' is no longer available. Use a 'filter' instead.

includeCred

boolean

Optional. Flag that specifies whether to include credentials in the response.

startKey

string

Returns the list of apps starting from the specified app ID.

rows

string (int64 format)

Optional. Maximum number of app IDs to return. Defaults to 1000, which is also the upper limit. To get more than 1000, use pagination with 'pageSize' and 'pageToken' parameters.

expand

boolean

Optional. Flag that specifies whether to return an expanded list of apps for the organization. Defaults tofalse.

ids

string

Optional. Comma-separated list of app IDs on which to filter.

keyStatus

string

Optional. Key status of the app. Valid values includeapproved orrevoked. Defaults toapproved.

apiProduct

string

API product.

pageSize

integer

Optional. Count of apps a single page can have in the response. If unspecified, at most 1000 apps will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. "pageSize" is supported from ver 1.10.0 and above.

pageToken

string

Optional. The starting index record for listing the developers. "pageToken" is supported from ver 1.10.0 and above.

filter

string

Optional. The filter expression to be used to get the list of apps, where filtering can be done on developerEmail, apiProduct, consumerKey, status, appId, appName, appType and appGroup. Examples: "developerEmail=foo@bar.com", "appType=AppGroup", or "appType=Developer" "filter" is supported from ver 1.10.0 and above.

Request body

The request body must be empty.

Response body

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

JSON representation
{"app":[{object (App)}],"nextPageToken":string,"totalSize":integer}
Fields
app[]

object (App)

nextPageToken

string

Token that can be sent asnextPageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

totalSize

integer

Total count of Apps.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.