List devices that have an app installed

get

https://api.controlup.com/compliance/apps/{id}/devices

Returns a paginated list of devices that have this application installed, including the installed version and remediation status on each device.

Path Params

string

required

The app_id returned in GET /apps.

Query Params

device_groups

string

Comma-separated device-group filter.

device_tags

string

Comma-separated device-tag filter.

app_version

string

^[A-Za-z0-9._+-]{1,64}$

Exact version match.

is_latest

boolean

Restrict to devices running the latest (true) or not (false).

remediation_availability

string

enum

Filter by whether a remediation is available for this app on the device.

Allowed:

cve_count_min

integer

≥ 0

Filter to devices where the app has at least this many CVEs.

page

integer

≥ 1

Page number to return. Starts at 1.

page_size

integer

1 to 100

Number of results per page. Maximum 100.

sort_by

string

enum

Field to sort results by.

Allowed:

sort_dir

string

enum

Defaults to asc for device_name, desc otherwise.

Allowed:

Responses

200Successful response

400Invalid query parameter

404App not found

500Internal server error