⚠️

Data export is disabled by default. Once enabled, files are created daily at midnight UTC. Queries return URLs for the latest files.

The Need for Data Export

While Armis Centrix™ provides various methods for data consumption and analysis, you may sometimes need to export data for further analysis outside of the platform. This is especially useful for integrating Armis' data with your own proprietary datasets.

Exportable Entities

The Armis API allows you to extract information for the following entities:

• Applications
• Risk Factors
• Vulnerabilities

Every time data is exported, it only takes into account devices that were seen in the last 30 days.

📘

All files are in Parquet file format, ideal for large data set. You can learn more about it here.

Example

Let's say you wish to export applications data from Armis Centrix™.

Step 1: enable export

Perquisites:

1. Access token with scopesPERMISSION.REPORT.MANAGE.CREATE and PERMISSION.REPORT.MANAGE.DELETE.

Send the request

import requests

entity = "applications"
body = {"enabled": True}
headers = {
    "Authorization": "Bearer <access_token>"
}

response = requests.patch(
    f"https://api.armis.com/v3/data-export/{entity}",
    json=body,
    headers=headers,
)

Detailed recipe

Step 2: wait for the files to be generated

Remember - when you enable data export for an entity, the first files will only be generated for the first time at the next midnight UTC (and on every following midnight UTC until disabled).

Step 3: Get the file URLs

⚠️

When you export data using this method, you gain access to all data for that entity. Therefore, the access token must have access to all data within the tenant, which in practice means access to all sites and boundaries.

Perquisites:

1. Access token with scopesPERMISSION.REPORT.READ and FULL_VISIBILITY.

Send the request

import requests

entity = "applications"
headers = {
    "Authorization": "Bearer <access_token>"
}

response = requests.get(
    f"https://api.armis.com/v3/data-export/{entity}",
    headers=headers,
)
response.raise_for_status()
print(response.json())

{
	"creation_time": "2025-09-08T00:00:00",
  "enabled": True,
  "urls": ["url1", "url2"],
  "file_format": "parquet",
}

Detailed recipe

Step 4: Open the files

Download and open the Parquet files from the provided URLs using tools like Trino, Pandas, etc.

⚠️

Links expire after 24 hours; download files promptly.