Submit a request for device location with address details

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

sends location co-ordinates to z-maps to get address

Request URL

https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}/locations_with_address

Scope

MDMInventory.CREATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

Content-TypestringMandatory
application/jsonapplication/jsonCopied!
AcceptstringMandatory
application/jsonapplication/jsonCopied!

- Path Parameters

device_idstringMandatory

Unique identifier of the device. Obtain from the Get Device List response

- Request Body

application/json
JSON Object
Hide Sub-Attributes
idlongMandatory

Device ID to request location for. Fetch from Get Device List

no_of_daysintegerOptional

Number of days of location history to retrieve

fromlongOptional

Start timestamp in milliseconds since epoch for the location range

tolongOptional

End timestamp in milliseconds since epoch for the location range

Sample Request

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:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"no_of_days":7,"from":1522066653883,"id":9007199254741000,"to":1557128715277}'

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_idlong

Batch ID used to query the result via the GET endpoint

waitinteger

Time in seconds to wait before calling GET for results

statusstring

Request status (e.g., SCHEDULED)

Possible Response Codes

200HTTP code

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.