Actions22
- Account Actions
- Automation Actions
- Device Actions
- Label Actions
- Mass Action Actions
- User Actions
- Zone Actions
Device → Get Device Reports
AI-generatedSummary
Retrieve a list of reports associated with a specific device by its ID.
Inputs
- API Key Permission — Select the permission level of the API key used (Read-Only or Read & Write). This determines available operations.
- Return All — Choose whether to retrieve all reports or limit the number returned.
- Limit — Specify the maximum number of reports to return if not returning all. Valid values are from 1 to 100.
- Device (required) — Select the target device by choosing from a list or inputting its ID directly.
- Request Options — Optional request settings including batching, SSL certification validation, proxy, and timeout.
Output shape
a list of report records for the specified device
The operation returns a list of reports under the 'reports' property. Pagination is supported: if Return All is true, multiple requests are made to fetch all pages. Otherwise, up to the specified limit of reports are returned. Each report includes an ID (used as the display name and identifier).
Examples
Example 1: Retrieve all reports for a device
Set 'Device' to the target device ID, set 'Return All' to true to fetch all reports.
Example 2: Retrieve up to 50 reports for a device
Set 'Device' to the target device ID, set 'Return All' to false, and set 'Limit' to 50.