Method: projects.contacts.list

Stay organized with collections Save and categorize content based on your preferences.

Lists the contacts that have been set on a resource.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource name. Format: organizations/{organization_id}, folders/{folder_id} or projects/{project_id}

Authorization requires the following IAM permission on the specified resource parent:

  • essentialcontacts.contacts.list

Query parameters



Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. If not specified, the default pageSize is 100.



Optional. If present, retrieves the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.

Request body

The request body must be empty.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.