Read alert setting
curl --request GET \
--url https://apiweb.mile.app/api/v4/alert-setting \
--header 'Authorization: Bearer <token>'import requests
url = "https://apiweb.mile.app/api/v4/alert-setting"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apiweb.mile.app/api/v4/alert-setting', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiweb.mile.app/api/v4/alert-setting",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apiweb.mile.app/api/v4/alert-setting"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apiweb.mile.app/api/v4/alert-setting")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiweb.mile.app/api/v4/alert-setting")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "Success",
"data": {
"geofence": true,
"idle": true,
"lateness": false,
"routeDeviation": false,
"overspeed": false,
"lowBattery": false,
"driverOffline": false,
"geofenceNotification": true,
"idleNotification": false,
"latenessNotification": true,
"routeDeviationNotification": true,
"overspeedNotification": true,
"lowBatteryNotification": true,
"driverOfflineNotification": true,
"updatedBy": "[email protected]",
"updatedTime": "2026-10-10T04:00:00.000Z",
"thresholds": {
"overspeed": {
"speedKmh": 80,
"consecutivePings": 3,
"repeatMinutes": 10
},
"idle": {
"distanceMeters": 50,
"windowMinutes": 30,
"repeatMinutes": 10
},
"lateness": {
"graceMinutes": 2
},
"routeDeviation": {
"distanceMeters": 150,
"consecutivePings": 3
},
"lowBattery": {
"percent": 15,
"resetPercent": 25,
"repeatMinutes": 30
},
"driverOffline": {
"minutes": 30
}
}
}
}Alert Setting
Read alert setting
Returns which alert types your organization records and which of them are also sent as notifications. When nothing has been saved yet, every type is off (false) and every notification flag is on (true). Alert types not listed here, such as panic alerts, are always recorded and notified.
thresholds lists the limits each alert type fires on, for example the speed limit of the overspeed alert. The values are the effective limits of your organization: the defaults (80 km/h, 50 m within 30 min, 2 min, 150 m, 15%, 30 min) unless you changed them with PUT /alert-setting. The number of location updates in a row (consecutivePings) and the repeat time (repeatMinutes) are fixed.
Requires permission view/alertSetting.
GET
/
alert-setting
Read alert setting
curl --request GET \
--url https://apiweb.mile.app/api/v4/alert-setting \
--header 'Authorization: Bearer <token>'import requests
url = "https://apiweb.mile.app/api/v4/alert-setting"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apiweb.mile.app/api/v4/alert-setting', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiweb.mile.app/api/v4/alert-setting",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apiweb.mile.app/api/v4/alert-setting"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apiweb.mile.app/api/v4/alert-setting")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiweb.mile.app/api/v4/alert-setting")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": true,
"message": "Success",
"data": {
"geofence": true,
"idle": true,
"lateness": false,
"routeDeviation": false,
"overspeed": false,
"lowBattery": false,
"driverOffline": false,
"geofenceNotification": true,
"idleNotification": false,
"latenessNotification": true,
"routeDeviationNotification": true,
"overspeedNotification": true,
"lowBatteryNotification": true,
"driverOfflineNotification": true,
"updatedBy": "[email protected]",
"updatedTime": "2026-10-10T04:00:00.000Z",
"thresholds": {
"overspeed": {
"speedKmh": 80,
"consecutivePings": 3,
"repeatMinutes": 10
},
"idle": {
"distanceMeters": 50,
"windowMinutes": 30,
"repeatMinutes": 10
},
"lateness": {
"graceMinutes": 2
},
"routeDeviation": {
"distanceMeters": 150,
"consecutivePings": 3
},
"lowBattery": {
"percent": 15,
"resetPercent": 25,
"repeatMinutes": 30
},
"driverOffline": {
"minutes": 30
}
}
}
}