# User$dataset

### Use&#x72;**$**<mark style="color:purple;">**dataset**</mark>**(*****dataset\_name**, \*, version="current"***)** → [Dataset](https://docs.redivis.com/api/client-libraries/redivis-r/reference/dataset)

Construct a new dataset instance that references a dataset owned by a user.

### **Parameters:**

**`dataset_name` :&#x20;*****str*** \
The name of the dataset, unique to the user. The name is case-insensitive, and can optionally be escaped following general [name escaping rules](https://docs.redivis.com/api/referencing-resources#escaping-names). E.g., `"GHCN Daily Weather Data"` -> `"ghcn_daily_weather_data"`.

**`version` :&#x20;*****str, default "current"***\
The version of the dataset, defaulting to the current version. Can either be "current", "next", or of the form "v1.0". If a dataset has never been released, the current version will be the same as the next version. If "next" is specified, but the dataset doesn't have a pending version, subsequent calls (e.g., `dataset$get()` will raise an error).

### **Returns:**

[**Dataset**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/dataset)

### Examples

```r
user <- redivis$user("imathews")
dataset <- user$dataset("us_political_boundaries")

dataset$get()
print(dataset$properties) # Properties will be fully populated after calling $get()
```