Analyses

Recover a file submission receipt

Read a saved receipt using the submitting identity and SHA-256, without resending bytes. A 404 does not prove an earlier upload was never dispatched. An uncertain outcome may remain unknown; do not automatically repeat POST.

get/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.

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.