---
title: Search devices by status
slug: cps-guide/mdm-epmm/search-devices-by-status
createdAt: 2026-10-06T07:45:20.659Z
---

This API returns the device information for devices with status specified in the request. If no status is specified in the request, details of all the devices is returned.

## HTTP Method

GET

## Request URI

/msa/v1/cps/device?status=\<DeviceStatus>\&offset=\<Integer>\&limit=\<Integer>

## Request parameters

| Parameter | Description                                                                         | Sample Value                                |
| --------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
| status    | **Parameter Type:** Query<br />**Data Type:** String                                | See [status](docId\:DK5wUaGcE74hME-EUyNkR). |
| offset    | **Parameter Type:&#x20;**&#x51;uery<br />**Data Type:** Number<br />**Default:** 0  | 0                                           |
| limit     | **Parameter Type:&#x20;**&#x51;uery<br />**Data Type:** String<br />**Default:** 50 | 50                                          |

## Response fields

A list of devices.

See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1) and [User](docId\:DK5wUaGcE74hME-EUyNkR).

## Example response

```javascript
{
   "searchResults": #List of devices,
   "results":2,
   "offset":0,
   "limit":50
}
```