# get

## HTTP Request

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

## Path parameters

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

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

## Authorization

Overview access to the dataset is required. If a dataset'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)

{% hint style="info" %}
If you are requesting the "next" (unreleased) version of a dataset, you must have edit access  to the dataset and use a token with data.edit scope.
{% endhint %}

## Request body

The request body must be empty.

## Response body

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