# Directory$list

### Directory$<mark style="color:purple;">list</mark>(*max\_results,* *mode, recursive*) → list([File](https://docs.redivis.com/api/client-libraries/redivis-r/reference/file) | [Directory](https://docs.redivis.com/api/client-libraries/redivis-r/reference/directory))

List the contents of a given directory.

### **Parameters:**

**`max_results` :&#x20;*****int, default NULL***\
If specified, will only list up to the specified number of files and/or directories

**`mode` :&#x20;*****"all" | "files" | "directories", default "all"***\
By default, this method will return a list of files *and* directories within the current directory. Specify an alternative mode to only list a given entity type.

**`recursive` :** ***bool, default FALSE***\
Whether to recursively crawl the directory tree and return all files and/or directories. If `FALSE` (the default), only entities directly in this directory will be returned.

### **Returns:**&#x20;

**list(** [**File**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/file) **|** [**Directory**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/directory) **)**

### Examples:

```r
dir <- redivis$table("table_ref")$to_directory()
print(dir$list()) # list files + directories within this directory

all_files <- dir$list(mode="files", recursive=TRUE)
```