# Query.list\_files

### Query.<mark style="color:purple;">list\_files</mark>(*max\_results=None, \*, file\_id\_variable=None, file\_name\_variable=None*) → list<[**File**](https://docs.redivis.com/api/client-libraries/redivis-python/file#class-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 None***\
If specified, will only return up to max\_results files

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

**`file_name_variable` :&#x20;*****str, optional***\
The name of the variable in the query result containing the file name. If unspecified, will look for a variable `file_name` , or otherwise will use the files' original name.

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

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