---
title: Get all Labels
slug: epmm/v1web-service-api-guide/get-all-labels
createdAt: 2026-11-03T13:27:46.519Z
---

Using labels is the method by which devices are grouped in the Ivanti EPMM database.  Labels can be used for applying policies or performing other management tasks on multiple devices. An administrator can create labels in addition to a default set supplied in Ivanti EPMM.  This API lists all labels, whether or not they are in use.

**Example**:

https\://\<Ivanti EPMM>/api/v1/dm/labels

| URI:<br />https\:///api/v1/dm/labels                                                                                                            | All labels in the database are returned.                                                                                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Http Method:                                                                                                                                    | GET                                                                                                                                                                                                                                                                                                          |
| Format:                                                                                                                                         | xml, json                                                                                                                                                                                                                                                                                                    |
|                                                                                                                                                 |                                                                                                                                                                                                                                                                                                              |
|                                                                                                                                                 |                                                                                                                                                                                                                                                                                                              |
| Response Status Code:                                                                                                                           |                                                                                                                                                                                                                                                                                                              |
| ‘404 – No Data Found’                                                                                                                           | There is no data.                                                                                                                                                                                                                                                                                            |
| ‘200 – OK’                                                                                                                                      | Data is present and the response is returned.                                                                                                                                                                                                                                                                |
| Response:                                                                                                                                       |                                                                                                                                                                                                                                                                                                              |
| \< deviceManagementWebServiceResponse >                                                                                                         |                                                                                                                                                                                                                                                                                                              |
| \<messages>                                                                                                                                     |                                                                                                                                                                                                                                                                                                              |
| \<message>1 Label (s) returned\</message>                                                                                                       | Status message.<br />A label count is shown if the method execution is successful.<br />A descriptive error message is shown if the method execution failed.                                                                                                                                                 |
| \</messages>                                                                                                                                    |                                                                                                                                                                                                                                                                                                              |
| \<labels>                                                                                                                                       |                                                                                                                                                                                                                                                                                                              |
|                                                                                                                                                 |                                                                                                                                                                                                                                                                                                              |
| \<label id=”-3”>                                                                                                                                | Internal database ID.<br />Negative numbers correspond to the default labels.<br />Positive numbers correspond to labels that Ivanti EPMM administrator added.                                                                                                                                               |
|                                                                                                                                                 |                                                                                                                                                                                                                                                                                                              |
|     \<name>iOS\</name>                                                                                                                          | Label name.                                                                                                                                                                                                                                                                                                  |
|     \<description>Label for all iOS devices.\</description>                                                                                     | Label description.                                                                                                                                                                                                                                                                                           |
|     \<staticLabel>false\</staticLabel>                                                                                                          | Static labels are system created labels. <br />False indicates a dynamic label.  Devices which satisfy the criteria specified in \<searchCriteria> are automatically added to this label.<br />True indicates a static label, which has no \<searchCriteria> Devices are manually assigned to static labels. |
|     \<query><br />        \&quot;common.platform\&quot;=\&quot;iOS\&quot; AND<br />       \&quot;common.retired\&quot;=false<br />    \</query> |                                                                                                                                                                                                                                                                                                              |
|     \<deviceCount>3\</deviceCount>                                                                                                              | The number of devices currently assigned to the label.                                                                                                                                                                                                                                                       |
|     \<isESSearch>116\</isESSearch>                                                                                                              |                                                                                                                                                                                                                                                                                                              |
| \<label>                                                                                                                                        |                                                                                                                                                                                                                                                                                                              |
| \</labels>                                                                                                                                      |                                                                                                                                                                                                                                                                                                              |
| \< /deviceManagementWebServiceResponse>                                                                                                         |                                                                                                                                                                                                                                                                                                              |
|                                                                                                                                                 |                                                                                                                                                                                                                                                                                                              |