# list

## HTTP Request

```http
GET /api/v1/datasets/:datasetReference/tables

GET /api/v1/workflows/:workflowReference/tables
```

## Path parameters

| Parameter         |                                                                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| datasetReference  | A qualified reference to the dataset. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information.  |
| workflowReference | A qualified reference to the workflow. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information. |

## Query parameters

| Parameter  |                                                                                              |
| ---------- | -------------------------------------------------------------------------------------------- |
| maxResults | Default 100. Must be less than 1000.                                                         |
| pageToken  | For paginating through results, provide the value returned from the previous table.list call |

{% hint style="info" %}
This endpoint extends the [general API structure](https://docs.redivis.com/api/rest-api/general-structure).
{% endhint %}

## Authorization

Only tables to which you have overview access will be returned. If a table's overview is not public, your access token must have one of the following scopes:

* data.overview
* data.metadata
* data.data
* data.edit

[Learn more about authorization.](https://docs.redivis.com/api/rest-api/authorization)

## Request body

The request body must be empty.

## Response body

Returns a JSON representation of an array of [table resources](https://docs.redivis.com/api/resource-definitions/table).

```javascript
{
    "kind": "tableList",
    "nextPageToken": integer,
    "results": [
        object(table.list)
    ]
}
```

## Examples

{% tabs %}
{% tab title="curl" %}

```bash
# List the tables on the EPA Air Quality dataset from the StanfordPHS organization
curl -H "Authorization: Bearer $REDIVIS_ACCESS_TOKEN" \
"https://redivis.com/api/v1/datasets/stanfordphs.epa_air_quality/tables"
```

{% endtab %}
{% endtabs %}