# Query$list\_files

### Query$<mark style="color:purple;">list\_files</mark>(*max\_results=NULL, \*, file\_id\_variable=NULL*) → list<[**File**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/file)>

Returns a list of files associated with the query results to the directory specified at path. Only relevant for queries against file index tables (the query result must also contain the file\_id variable). If the query results contain multiple file id variables, must specify the `file_id_variable` parameter.

### **Parameters:**

**`max_results` :&#x20;*****int, default NULL***\
If specified, will only return up to max\_results files

**`file_id_variable` :&#x20;*****str, default NULL***\
The variable in the query results containing file ids. Only required if the query results contains more than one file id variable.

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

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