Skip to main content
GET

Overview

The Devices endpoint provides access to ThreatAware’s unified device inventory, aggregating data from all connected integrations. This is the primary endpoint for device information.

Parameters

string
required
Filter devices based on their current stateOptions:
  • active - Devices online within threshold (default 30 days)
  • inactive - Devices offline longer than threshold
  • all - All devices regardless of state
number
default:"0"
Set the start position of the data returned by the API
number
default:"0"
Limit each request by the provided number. Leave blank or as 0 to return all data available

Authentication

string
required
Your ThreatAware API key
string
default:"application/json"
Response format

Response

number
The starting position of this result set
number
The number of results returned
number
Total number of devices available
boolean
Whether the request was successful
number
HTTP status code
string
Status message
array

Use Cases

CMDB Synchronization

Export device inventory to ServiceNow, Jira, or other CMDBs

Security Dashboards

Build Power BI, Tableau, or custom dashboards from device data

Asset Management

Track hardware lifecycle, warranty status, and replacement planning

Compliance Reporting

Generate device compliance reports for audits and certifications

Vitals

Get security control health status for devices