Analyses

Read a submitted analysis

Read an analysis registered to the same submitting identity. Follow top-level status and next_poll_after_seconds within a finite budget; pending can coexist with analysis_status completed while verification finishes. A completed analysis is not a safety verdict.

get/api/v3/analyses/{analysis_id}

Request

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

Path parameters

analysis_idstring required

Opaque analysis ID returned by this identity's submission, at most 1024 UTF-8 bytes. Preserve the exact ID and URL-encode it as a path value; it can contain slashes. Whitespace and control characters are not accepted.

Query parameters

request_idstring nullable

Saved lowercase UUIDv4 for a network submission. Selects its receipt if an upstream analysis ID is reused; omit for file submissions.

Response

Successful Response

OR

Changes

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