API Reference

Upload a file

post
https://www.virustotal.com/api/v3/private/files

Privately upload and analyse a file.

📘

File size

If the file to be uploaded is bigger than 32MB, please use the /private/files/upload_url endpoint instead which admits files up to 650MB.

Body Params

File to scan

file
required
string
Defaults to false

If true, then the file won't be detonated in sandbox environments. False by default.

string
Defaults to false

If the file should have internet access when running in sandboxes. False by default.

string
Defaults to false

Intercept HTTPS/TLS/SSL communication. Intercept HTTPS to view encypted URLS, hostnames and HTTP headers. This is detectable by any sample that checks certificates, and makes JA3 hashes unusable.

string

Command line arguments to use when running the file in sandboxes.

string

Optional, password to decompress and scan a file contained in a protected ZIP file.

integer

Optional, number of days the report and file are kept in VT (between 1 and 28). If not set it defaults to the group's retention policy preference (1 day by default).

string

Optional, storage region where the file will be stored. By default uses the group's private_scanning.storage_region preference. Allowed values are US, EU.

string

Select the sandbox desired for interactive use.

integer

Interaction timeout in seconds, minimum value: 60. (1 minute.) Max value: 1800: (30 minutes)

string
enum
Defaults to EN_US

Preferred sandbox locale. On windows this selection will change the language and keyboard settings of the analysis machine.

Allowed:
Headers
string
required

Your API key

Responses

400

If password was provided and the file isn't a ZIP, it contains more than one file, the password is incorrect, or the file is corrupt.

Updated 6 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago