Get list of web address browsing tasks

Expand all | Collapse all

The /sandbox/tasks/url endpoint is used to obtain a list of tasks for the web address.

Request

Request method: GET

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

Query parameters:

Expected parameters

Parameter

Description

status

Task state.

Optional parameter. If this parameter is not specified, information about active tasks is returned. Available values:

all—All tasks.

active—Tasks with one of the following statuses:

  • in-progress—Task is running.
  • completed—Process completed successfully.
  • completed-with-errors—Error occurred during the web address browsing, but the task is completed.
  • failed—Failed to complete the 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:

To get a list of tasks for browsed web addresses:

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

Responses

200 OK

401 Unauthorized

403 Forbidden

451 Unavailable For Legal Reasons

Page top