Method: projects.getIamPolicy

Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.

Authorization requires the Google IAM permission resourcemanager.projects.getIamPolicy on the project.

For additional information about resource (e.g. my-project-id) structure and identification, see Resource Names.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.

Request body

The request body contains data with the following structure:

JSON representation
  "options": {
    object (GetPolicyOptions)

object (GetPolicyOptions)

OPTIONAL: A GetPolicyOptions object for specifying options to projects.getIamPolicy.

Response body

If successful, the response body contains an instance of Policy.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.