# get

{% hint style="warning" %}
**Beta notice**\
\
We are currently gathering feedback on the Access API endpoints, and while in beta the structure of the API and its response may change. Please submit any feedback (including if this API currently works for your needs!) to your primary Redivis contact, or <support@redivis.com>.&#x20;
{% endhint %}

## HTTP Request

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

## Path parameters

| Parameter        | Description                                                                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| userName         | The userName of the particular user that you want to observe access for                                                                     |
| datasetReference | A qualified reference to the dataset. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information. |

## Query parameters

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

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

## Authorization

You must be an administrator of the organization that hosts the dataset, or, if the dataset is owned by a user, you must be the owner or an editor on the dataset.

Your access token must have one of the following scopes:

* organization.read

[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 [access resource](https://docs.redivis.com/api/resource-definitions/access).