OData Version 4.0 filter string (limited functionality). Supports only 'and', 'eq', and 'in' conjunction ('or' and 'not' are NOT supported). Supported fields and operators are in the table below. Multiple filters are supported.
| Field | Operators | Required | Type | Default Value | Summary |
|---------|-----------|----------|---------|----------------|-------------------------------------------------------------------|
| field | eq | No | String | N/A | Format is a string from a specified enum list given below |
| terms | in | No | String | N/A | Format is a list of strings |
The operators are implemented as follows:
eq: Only values exactly matching the given value are returned.in: Only values present in the given list are returned.
List of applicable filters for field and terms
| Field | Applicable Terms | Summary |
|---|
| APP_CAT | Refer to list below. Example: ["Antivirus", "Web"] | Returns applications based on application categories |
| STATE | ["allowed", "partial", "blocked"] | Returns applications by assigned permissions |
| RISK | ["Low", "High", "Suspicious", "Moderate", "Trustworthy", "Not Evaluated"] | Returns applications based on risk level |
| TLS_VERSION | ["TLS 1.1", "TLS 1.2"] (examples) | Returns applications by TLS version |
| APPLICATION_HOST_TYPE | ["Hybrid", "Private", "Public"] | Returns applications by host type |
| COUNTRY | Depends on app server location (use country code, e.g., "IN") | Returns applications by server location |
| ROLE | Depends on roles assigned to the user | Returns applications by assigned roles |
List of application categories available:
- Antivirus
- Business and Economy
- Computer and Internet Info
- Computer and Internet Security
- Encrypted
- Internet Communications
- Network Service
- Office365 SAAS
- Standard
- Web
If no filter is passed as the query param, default behavior returns both active and inactive applications.
