- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Examples
- Try it!
Lists every ServiceAccount
that belongs to a specific project.
HTTP request
GET https://iam.googleapis.com/v1/{name=projects/*}/serviceAccounts
The URL uses gRPC Transcoding syntax.
Path parameters
name
string
Required. The resource name of the project associated with the service accounts, such as projects/my-project-123
.
Authorization requires the following IAM
permission on the specified resource name
:
-
iam.serviceAccounts.list
Query parameters
| Parameters | |
|---|---|
pageSize
|
Optional limit on the number of service accounts to include in the response. Further accounts can subsequently be obtained by including the The default is 20, and the maximum is 100. |
pageToken
|
Optional pagination token returned in an earlier |
Request body
The request body must be empty.
Response body
The service account list response.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"accounts"
:
[
{
object (
|
| Fields | |
|---|---|
accounts[]
|
The list of matching service accounts. |
nextPageToken
|
To retrieve the next page of results, set |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/iam -
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

