RPC to list projects to which the user has been granted any project role.
Users of this method are encouraged to consider the Resource Manager API, which provides the underlying data for this method and has more capabilities.
HTTP request
GET https://bigquery.googleapis.com/bigquery/v2/projects
maxResults unset returns all results, up to 50 per page. Additionally, the number of projects in a page may be fewer than maxResults because projects are retrieved and then filtered to only projects with the BigQuery API enabled.
pageToken
string
Page token, returned by a previous call, to request the next page of results. If not present, no further pages are present.
Request body
The request body must be empty.
Response body
Response object of projects.list
If successful, the response body contains data with the following structure:
[[["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-07-02 UTC."],[[["\u003cp\u003eThis method lists projects to which a user has been granted any project role, with a recommendation to consider the more capable Resource Manager API.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://bigquery.googleapis.com/bigquery/v2/projects\u003c/code\u003e and it uses gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters include \u003ccode\u003emaxResults\u003c/code\u003e to control the number of results per page (up to 50) and \u003ccode\u003epageToken\u003c/code\u003e to navigate through multiple pages of results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response body includes a JSON representation with details about the projects, including their IDs, names, and references.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the specified OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ProjectList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRPC to list projects to which the user has been granted any project role.\n\nUsers of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities.\n\n### HTTP request\n\n`GET https://bigquery.googleapis.com/bigquery/v2/projects`\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\nResponse object of projects.list\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/bigquery`\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/bigquery.readonly`\n- `https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]