Submit a request for device location with address details sends location co-ordinates to z-maps to get address
Request URL https://{serverurl} /api/v1/mdm/devices/{device_id}/locations_with_address
Scope
Header Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Path Parameters - Request Body application/json JSON object
Hide Sub-Attributes no_of_days integer Optional
Number of days of location history to retrieve
from long Optional
Start timestamp in milliseconds since epoch for the location range
to long Optional
End timestamp in milliseconds since epoch for the location range
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/api/v1/mdm/devices/{device_id}/locations_with_address \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"id":9007199254741000}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/api/v1/mdm/devices/{device_id}/locations_with_address"))
.header("Content-Type", "application/json")
.header("Accept", "application/json")
.header("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"id\":9007199254741000}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"id\":9007199254741000}"
headers = {
'Content-Type': "application/json",
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/api/v1/mdm/devices/{device_id}/locations_with_address", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/json");
headersMap.put("Accept", "application/json");
data=Map();
data.put("id","1");
response = invokeUrl
[
url: "https://appDomain/api/v1/mdm/devices/{device_id}/locations_with_address"
type: POST
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/v1/mdm/devices/{device_id}/locations_with_address' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"id":9007199254741000}'Sample Request Body Request location with address for last 7 days
Copied!
{
"no_of_days": 7,
"from": 1522066653883,
"id": 9007199254741000,
"to": 1557128715277
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON object
Hide Sub-Attributes export_batch_id long
Batch ID used to query the result via the GET endpoint
wait integer
Time in seconds to wait before calling GET for results
status string
Request status (e.g., SCHEDULED)
Possible Response Codes Sample Response: HTTP 200 Location request scheduled successfully
Copied!
{
"export_batch_id": 900234566788909,
"wait": 500,
"status": "SCHEDULED"
}
▼ Show full
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold. Threshold - Number of API calls allowed within the specified duration. Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.