Prey icon

Prey

Manage devices and account data in Prey

Device → Get Device Reports

AI-generated

Summary

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.

Links

Discussion