Get list of uploaded and executed file tasks (Sandbox)

Expand all | Collapse all

The /sandbox/tasks/file endpoint is used to obtain results of uploaded file execution tasks in Kaspersky Sandbox.

Request

Request method: GET

Endpoint: https://tip.kaspersky.com/api/sandbox/tasks/file

Query parameters:

Expected parameters

Parameter

Description

status

Object execution task state.

Optional parameter. If this parameter is not specified, information about active object execution tasks is returned.

Available values:

all—All object execution tasks.

active—Object execution tasks with one of the following states:

  • in-progress—Object execution task is running.
  • completed—Execution process completed successfully.
  • completed-with-errors—Error occurred during the object execution, but the task is completed.
  • failed—Failed to complete the execution task.

The active variable is used by default.

count

Maximum number of entries to return.

Optional parameter. If this parameter is not specified, information about 2000 object execution tasks is returned.

Request example:

Get a list of tasks for uploaded and executed files:

curl -u <user name> --cert <full path to the certificate on your computer> -X GET 'https://tip.kaspersky.com/api/sandbox/tasks/file'

Responses

200 OK

401 Unauthorized

403 Forbidden

451 Unavailable For Legal Reasons

Page top