Advanced File API Filtering and Sorting

Filtering and sorting on the File and PDF report APIs include support for a variety of filter and sort combinations.

Some filtering and all sorting parameters support sending a list of values separated by comma, which take part of a logical OR filter (the property can be any of the given values).

Filtering

Filtering supports the following query parameter fields:

Query parameterPossible valuesDescriptionAllows list of values
startDateA valid DateTimeno
endDateA valid DateTimeno
searchA string valueno
scanType
  • 0 = Instant
  • 1 = Scheduled
  • 2 = RealTime
yes
storageIdA valid storage idyes
scanIdA valid scan idyes
scanWorkflowSnapshotIdA valid snapshot idyes
processingState
  • InProgress = 0
  • Failed = 1
  • Canceled = 2
  • Available = 3
State of processing in MDSSyes
result
  • 0 = Allowed
  • 1 = Blocked
  • 2 = Processing
Result of MDSSyes
scanAllResultI General result of the Scan Instanceyes
scanResultICountAn integer >= 0The number of engine results that are not "No threat detected"yes
vulnerabilityCountAn integer >= 0The number of vulnerabilities detectedyes
dlpDetectionBoolean true or falseDLP detectionno
remediations
  • 0 = Tagging
  • 1 = DeepCdrSanitization
  • 2 = DeepCdrDelete
  • 3 = DeepCdrEncrypt
  • 4 = DeepCdrKeep
  • 5 = AllowedMoved
  • 6 = BlockedMoved
  • 7 = BlockedDelete
  • 8 = SanitizedMoved
  • 9 = AllowedCopied
  • 10 = BlockedCopied
  • 11 = SanitizedCopied
  • 100 = SoftDelete
Remediations performedyes

Sorting

Sorting supports multiple parameters, which are used if there is an equality between the values of the preceding sort. If multiple sorts are used, the property and order are matched in order between the two lists of values. The following query parameter fields are available:

Query parameterPossible values
sortBy
  • 0 = DiscoveryStarted
  • 1 = ScanId
  • 2 = ProcessingState
  • 3 = Result
  • 4 = ScanAllResultI
  • 5 = ScanResultICount
sortOrder
  • 0 = Ascending
  • 1 = Descending
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard