Scan API Endpoint

This API endpoint allows users to submit a file or archive that will get converted into one or multiple (in the case of archives with multiple files) tasks. The list of accepted files for processing are returned in the "acceptedFiles" array, files with unsupported file type (or rejected for another reason, e.g. because they are too large) will be found in the "rejectedFiles" array. The call is asynchronous and will return immediately. Using the submission ID, the execution status and results can be retrieved later via the /submit-result or /task endpoints.

Syntax

POST https://<ip>:<port>/submit

Parameters

NameTypeRequired?Description
serectStringYAuthentication secret
priorityIntegerNProcessing priority (0 = default, 100 = highest)
passwordStringNArchive password
skipWhitelistedFilesBooleanNReject submitted files, if their hash (MD5/SHA-256) is on an internal or external whitelist
transformOpt.[option]StringN

Set custom transform options that differ from the default backend configuration.

Available options:

  • rapidMode
  • runOSINTLookups
  • runExtendedOSINTLookups
  • runOSINTLookupsOnExtractedFiles
  • runFileVisualizer
  • runFileDownloaders
  • runDomainResolver
  • runYaraRulesOnInputFile
  • runYaraRulesOnExtractedFiles
  • runWhoisRecordLookups
  • runIPStackLookupOnExectractedHosts
  • runTesseractOCRForImages

Note: rapidMode sets an even extended set of options to fully optimize for speed. It will override any other option, if enabled

$_FILEOctet-StreamYFile/Archive as form-data body
urlStringNURL to file

Example Response

JSON
Copy

Note: if a file gets rejected, appropriate data will be presented in the "rejectedFiles" array including a "rejectedReason" field.

JSON
Copy

Possible values for “rejectedReason”:

  • EMPTY_FILE
  • TOO_LARGE_FILE
  • DIRECTORY
  • ARCHIVE_UNPACKED
  • ARCHIVE_INVALID
  • ARCHIVE_ENCRYPTED
  • ARCHIVE_ZIPBOMB
  • INVALID_PASSWORD
  • UNSUPPORTED_FILE_FORMAT
  • SERVER_FULL
  • INTERNAL_ERROR
  • WHITELISTED
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard