---
title: Locate a Device
slug: epmm/v1web-service-api-guide/locate-a-device
createdAt: 2026-11-03T13:28:24.410Z
---

The Ivanti EPMM Client periodically records cell tower location information.  When this API is used, the last known location of the device is returned based on requested unique device ID (uuid).  If needed, this API will remotely turn on a device’s GPS.  To find the current location of the device:

1\.	Call this API with locatenow=true. This will send a request to the device to determine the current location. This process might take between a few seconds and 1 minute.
2\.	Call the locate API again after a few minutes without the locatenow parameter . This will return the current location found from step 1. If the current location could not be determined it will return the last known location.
You can use this API with ServiceNow.

**Examples**:

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/ee8198d9-5d79-4961-94c4-e21bf04b2467

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/mac/38AA3C62BFAD

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/ee8198d9-5d79-4961-94c4-e21bf04b2467?locatenow=true

:::hint{type="info"}
You can use this API with ServiceNow.
:::

**Examples**:

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/ee8198d9-5d79-4961-94c4-e21bf04b2467

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/mac/38AA3C62BFAD

https\://\<Ivanti EPMM>/api/v1/dm/devices/locate/ee8198d9-5d79-4961-94c4-e21bf04b2467?locatenow=true

| 1.URI:<br />https\:///api/v1/dm/devices/locate/                 | Location of the device with the input device uuid is returned.                                                                                                                                                                                    |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Http Method:                                                    | GET                                                                                                                                                                                                                                               |
| Format:                                                         | xml, json                                                                                                                                                                                                                                         |
| Request:                                                        |                                                                                                                                                                                                                                                   |
| Device UUID                                                     | Required. Unique ID of the device. This ID is sent in the response of the Registration API.                                                                                                                                                       |
| locatenow                                                       | Optional. True or false.  Defaults to false. See step 1 in the explanation above. This parameter does not apply to iOS.                                                                                                                           |
|                                                                 |                                                                                                                                                                                                                                                   |
| 2.URI:<br />https\:///api/v1/dm/devices/locate/mac/             | Location of the device with the input Wi-Fi MAC address  is returned.                                                                                                                                                                             |
| Http Method:                                                    | GET                                                                                                                                                                                                                                               |
| Format:                                                         | xml, json                                                                                                                                                                                                                                         |
| Request:                                                        |                                                                                                                                                                                                                                                   |
| macAddress                                                      | Required.                                                                                                                                                                                                                                         |
| locatenow                                                       | Optional. True or false.  Defaults to false. See step 1 in the explanation above. This parameter does not apply to iOS.                                                                                                                           |
|                                                                 |                                                                                                                                                                                                                                                   |
| Response Status Code:                                           |                                                                                                                                                                                                                                                   |
| ‘404 – No Data Found’                                           | There is no data.                                                                                                                                                                                                                                 |
| ‘200 – OK’                                                      | Data is present and the response is returned.                                                                                                                                                                                                     |
| Response:                                                       |                                                                                                                                                                                                                                                   |
| \< deviceManagementWebServiceResponse >                         |                                                                                                                                                                                                                                                   |
| \<deviceUuid>cf667a65-1e1a-4121-af63-398b11540d2f\</deviceUuid> | Unique Device ID.                                                                                                                                                                                                                                 |
| \<messages>                                                     |                                                                                                                                                                                                                                                   |
| \<message>\</message>                                           | Status Message.<br />Success is shown if the method execution is successful.<br />A descriptive error message is shown if the method execution failed.                                                                                            |
| \</messages>                                                    |                                                                                                                                                                                                                                                   |
| \<locations>                                                    |                                                                                                                                                                                                                                                   |
| \<location>                                                     |                                                                                                                                                                                                                                                   |
| \<uuid>cf667a65-1e1a-4121-af63-398b11540d2f\</uuid>             | Unique Device ID.                                                                                                                                                                                                                                 |
| \<lookupResult>Cell\</lookupResult>                             | Value returned describes how location was retrieved.  Valid values:<br />LookupFailure: unable to retrieve the location of the device.<br />GPS: location retrieved using the GPS of the device.<br />Cell: location retrieved using cell towers. |
| \<latitude>37.386433\</latitude>                                | Latitude of the location of the device.                                                                                                                                                                                                           |
| \<longitude>-122.053902\</longitude>                            | Longitude of the location of the device.                                                                                                                                                                                                          |
| \<radius>1500\</radius>                                         |                                                                                                                                                                                                                                                   |
| \<capturedAt>1285802663000\</capturedAt>                        | Time when the location of the device was captured in epoch format.                                                                                                                                                                                |
| \</location>                                                    |                                                                                                                                                                                                                                                   |
| \</locations>                                                   |                                                                                                                                                                                                                                                   |
| \<locateNow>false\</locateNow>                                  |                                                                                                                                                                                                                                                   |
| \< /deviceManagementWebServiceResponse>                         |                                                                                                                                                                                                                                                   |
|                                                                 |                                                                                                                                                                                                                                                   |

##