Method: tables.list

Lists all tables in the specified dataset. Requires the READER dataset role.

HTTP request

GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets/{datasetId}/tables

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. Project ID of the tables to list

datasetId

string

Required. Dataset ID of the tables to list

Query parameters

Parameters
maxResults

integer

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

Request body

The request body must be empty.

Response body

Partial projection of the metadata for a given table in a list response.

If successful, the response body contains data with the following structure:

JSON representation
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "tables": [
    {
      "kind": string,
      "id": string,
      "tableReference": {
        object (TableReference)
      },
      "friendlyName": string,
      "type": string,
      "timePartitioning": {
        object (TimePartitioning)
      },
      "rangePartitioning": {
        object (RangePartitioning)
      },
      "clustering": {
        object (Clustering)
      },
      "hivePartitioningOptions": {
        object (HivePartitioningOptions)
      },
      "labels": {
        string: string,
        ...
      },
      "view": {
        "useLegacySql": boolean,
        "privacyPolicy": {
          object (PrivacyPolicy)
        }
      },
      "creationTime": string,
      "expirationTime": string,
      "requirePartitionFilter": boolean
    }
  ],
  "totalItems": integer
}