Get the URLs of the latest data exports of a particular entity.

get

https://api.armis.com/v3/data-export/{entity}

Each time_frame_days value of an entity is exported separately, so
applications with time_frame_days=7 and applications with time_frame_days=30 are two independent exports
that are enabled, disabled and read on their own. Omitting time_frame_days addresses the entity's default window.

Entity	Supported `time_frame_days`	Default	Notes
`applications`	2, 7, 14, 30	30
`device-delete-events`	2, 7, 14, 30, 90	14
`device-merge-events`	2, 7, 14, 30, 90	14
`ip-connections`	1-7	-	accepted when reading, to pick the aggregation date; cannot be set when enabling the export
`risk-factors`	2, 7, 14, 30	30
`vulnerabilities`	2, 7, 14, 30	30

Required scopes:

PERMISSION.REPORT.READ
FULL_VISIBILITY

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

entity

string

enum

required

Allowed:

Query Params

time_frame_days

Size of the exported time window, in days.

Supported values differ per entity. Omit to use the entity's default.

Entity	Supported `time_frame_days`	Default	Notes
`applications`	2, 7, 14, 30	30
`device-delete-events`	2, 7, 14, 30, 90	14
`device-merge-events`	2, 7, 14, 30, 90	14
`ip-connections`	1-7	-	accepted when reading, to pick the aggregation date; cannot be set when enabling the export
`risk-factors`	2, 7, 14, 30	30
`vulnerabilities`	2, 7, 14, 30	30

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Response

422Validation Error