The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.
pageToken
string
Page token, returned by a previous call, to request the next page of results
all
boolean
Whether to list all datasets, including hidden ones
filter
string
An expression for filtering the results of the request by label. The syntax islabels.<name>[:<value>]. Multiple filters can be AND-ed together by connecting with a space. Example:labels.department:receiving labels.active. SeeFiltering datasets using labelsfor details.
Request body
The request body must be empty.
Response body
Response format for a page of results when listing datasets.
If successful, the response body contains data with the following structure:
Output only. The resource type. This property always returns the value "bigquery#datasetList"
etag
string
Output only. A hash value of the results page. You can use this property to determine if the page has changed since the last request.
nextPageToken
string
A token that can be used to request the next results page. This property is omitted on the final results page.
datasets[]
object
An array of the dataset resources in the project. Each resource contains basic information. For full information about a particular dataset resource, use the Datasets: get method. This property is omitted when there are no datasets in the project.
datasets[].kind
string
The resource type. This property always returns the value "bigquery#dataset"
datasets[].id
string
The fully-qualified, unique, opaque ID of the dataset.
[[["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 API endpoint retrieves a list of datasets within a specified project that the user has been granted the READER dataset role for.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003eGET\u003c/code\u003e method to a specific URL that includes the project ID in the path: \u003ccode\u003ehttps://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters can be used to refine the search, such as \u003ccode\u003emaxResults\u003c/code\u003e to limit the number of results, \u003ccode\u003epageToken\u003c/code\u003e for pagination, \u003ccode\u003eall\u003c/code\u003e to include hidden datasets, and \u003ccode\u003efilter\u003c/code\u003e to filter datasets by labels.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of dataset resources, each with properties like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003edatasetReference\u003c/code\u003e, \u003ccode\u003elabels\u003c/code\u003e, \u003ccode\u003efriendlyName\u003c/code\u003e, and \u003ccode\u003elocation\u003c/code\u003e, and it may include a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving additional results.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires specific OAuth scopes, including \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery.readonly\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform.read-only\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: datasets.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.DatasetList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all datasets in the specified project to which the user has been granted the READER dataset role.\n\n### HTTP request\n\n`GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse format for a page of results when listing datasets.\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)."]]
