---
title: "getFileMonitorList"
canonical: "https://support.appfire.com/space/CSOAP/1493046871/getFileMonitorList"
format: markdown
---
> Macro (aura-html)

See also: [System Client Actions](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/1493046719)

> Macro (details)
> 
> | **Description** | Get list of file system events monitored for a given directory with regex filtering on file path and satisfying other selection criteria. Note that results are only produced once the monitor is stopped by either timeout or limit. |
> | --- | --- |
> | **Required Parameters** | [directory](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/527336192), [events](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458638) |
> | **Optional Parameters** | [limit](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459009), [regex](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458942), [options](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459041), [outputType](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459055), [file](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455055), [append](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68454814), [columns](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459679), [select](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68453905), [encoding](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458746) |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/1493047621/System+Client+Action+Types#SystemClientActionTypes-Get) |
> | **Category** | [Files](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/1493046572/System+Client+Action+Categories#SystemClientActionCategories-Files) |
> | **Output Formats** |  |
> | **Replacement Variables** |  |
> | **Since Version** | 9.4 |
> | **Examples** | [getFileMonitorList](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/1493046528/System+Client+Examples#getFileMonitorList) |

## Related How To's

> Macro (cql-query)