Projects: list

Requires authorization

Lists all projects to which you have been granted any project role.


HTTP request



Parameter name Value Description
Optional query parameters
maxResults unsigned integer Maximum number of results to return
pageToken string Page token, returned by a previous call, to request the next page of results


This request requires authorization with at least one of the following scopes (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "bigquery#projectList",
  "etag": etag,
  "nextPageToken": string,
  "projects": [
      "kind": "bigquery#project",
      "id": string,
      "numericId": unsigned long,
      "projectReference": {
        "projectId": string
      "friendlyName": string
  "totalItems": integer
Property name Value Description Notes
kind bigquery#projectList The type of list.
etag etag A hash of the page of results
nextPageToken string A token to request the next page of results.
projects[] list Projects to which you have at least READ access.
projects[].kind string The resource type.
projects[].id string An opaque ID of this project.
projects[].projectReference nested object A unique reference to this project.
projects[].projectReference.projectId string [Required] ID of the project. Can be either the numeric ID or the assigned ID of the project.
projects[].friendlyName string A descriptive name for this project.
totalItems integer The total number of projects in the list.
projects[].numericId unsigned long The numeric ID of this project.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.