Analyses

Submit File

post/api/v3/submissions/{sha256}

Request

  • Base URL: https://ai.virustotal.com
  • URL: https://ai.virustotal.com/api/v3/submissions/{sha256}
  • Auth: one of:
    • API key in header x-apikey
    • HTTP bearer

Path parameters

sha256string required

Lowercase SHA-256 of the exact file bytes; retain it to recover the receipt with the same identity.

Headers

X-VTAI-Consent'standard-v1' required

Explicit consent to standard VirusTotal submission; not private scanning.

Response

Successful Response

status'submitted' | 'submission_unknown' | 'exists' required
mode'standard'
submission_idstring required
sha256string required
sizeinteger required
analysis_idstring nullable required
analysis_status'queued' | 'in-progress' | 'completed' nullable
next_poll_after_seconds5 nullable required
can_resubmitfalse

Changes

No recorded changes to this operation across all 1 revision of this API.