Optional. The maximum number of results to return. The service can return fewer than this number. If omitted or set to 0, the default is 50 results per page. The maximum allowed value is 100.pageSizevalues greater than 100 default to 100.
pageToken
string
Optional. The pagination token received from a prior call to PoliciesService.ListPolicies to retrieve the next page of results. When paginating, all other parameters provided toListPoliciesRequestmust match the call that provided the page token.
filter
string
Optional. A CEL expression for filtering the results.
Policies can be filtered by application with this expression: setting.type.matches('^settings/gmail\..*$') Policies can be filtered by setting type with this expression: setting.type.matches('^.*\.service_status$') A maximum of one of the above setting.type clauses can be used.
Policies can be filtered by customer with this expression: customer == "customers/{customer}" Wherecustomeris theidfrom theAdmin SDKCustomerresource. You may usecustomers/my_customerto specify your own organization. When no customer is mentioned it will be default to customers/my_customer. A maximum of one customer clause can be used.
The above clauses can only be combined together in a single filter expression with the&&operator.
[[["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 policies using the \u003ccode\u003eGET https://cloudidentity.googleapis.com/v1beta1/policies\u003c/code\u003e HTTP request, which uses gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the number of results returned per page using the \u003ccode\u003epageSize\u003c/code\u003e query parameter, with a default of 50 and a maximum of 100.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epageToken\u003c/code\u003e query parameter allows for pagination, enabling the retrieval of subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter policies by application, setting type, or customer using the \u003ccode\u003efilter\u003c/code\u003e query parameter with CEL expressions, which have specific syntax requirements and limitations on combining clauses.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of policies in the \u003ccode\u003epolicies\u003c/code\u003e field and a \u003ccode\u003enextPageToken\u003c/code\u003e field for pagination.\u003c/p\u003e\n"]]],[],null,["# Method: policies.list\n\nList Policies\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1beta1/policies`\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\nThe response message for [PoliciesService.ListPolicies](/identity/docs/reference/rest/v1beta1/policies/list#google.apps.cloudidentity.policies.v1beta1.PoliciesService.ListPolicies).\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.policies.readonly`\n- `https://www.googleapis.com/auth/cloud-identity.policies`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
