Speed Report

Overspeed events across your fleet — location, speed, duration, and optional radar proximity data.

GET/apidev/v1/reports/avl/speed

PermissionAPICLI_RPTAVL_VELOCIDAD

Rate Limit10 req/min (sliding window)

Cache300s (5 min)

Max Range31 days

---

Overview

Identifies all instances where a vehicle exceeded a given speed threshold. Each overspeed event is recorded with its location, speed, and optional radar proximity.

• Custom threshold — speed_threshold defines the speed limit for detection (default 80 km/h)
• Duration filtering — duration_min excludes brief speed spikes
• Radar enrichment — radars=true includes nearby radar/speed-camera POIs
• Subtotals — subtotals=true for aggregated summaries

---

Query Parameters

Parameter	Type	Required	Default	Description
startdate	string	Yes	—	ISO 8601 start date-time (e.g. 2026-03-01T00:00:00)
enddate	string	Yes	—	ISO 8601 end date-time. Max range 31 days
devices	string	No	All visible	Comma-separated device IDs. Max 500
speed_threshold	integer	No	80	Speed threshold in km/h (1–300). Events above this are reported
duration_min	integer	No	0	Minimum overspeed duration in minutes. Shorter events are excluded
subtotals	boolean	No	false	Include subtotal rows
radars	boolean	No	false	Include nearby radar/speed-camera POI data
limit	integer	No	25	Records per page (1–100)
offset	integer	No	0	Records to skip

---

Code Examples

cURL

curl -s "https://$TENANT/apidev/v1/reports/avl/speed?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=50&speed_threshold=90" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT"

JavaScript

const params = new URLSearchParams({
  startdate: "2026-03-01T00:00:00",
  enddate: "2026-03-15T23:59:59",
  limit: "50",
  speed_threshold: "90",
});

const response = await fetch(
  `https://${TENANT}/apidev/v1/reports/avl/speed?${params}`,
  { headers }
);

const { data, meta } = await response.json();
for (const event of data) {
  console.log(`${event.device_name}: ${event.speed} km/h at ${event.address}`);
}

Python

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/avl/speed",
    headers=headers,
    params={
        "startdate": "2026-03-01T00:00:00",
        "enddate": "2026-03-15T23:59:59",
        "limit": 50,
        "speed_threshold": 90,
    },
)

result = response.json()
for event in result["data"]:
    print(f"{event['device_name']}: {event['speed']} km/h — {event['address']}")

---

Response Fields

Field	Type	Description
device_name	string	Display name of the vehicle/device
person_name	string	Name of the assigned driver at the time of the event
datetime	string | null	Timestamp when the overspeed event was recorded
address	string	Reverse-geocoded address where the event occurred
speed	number	Speed recorded at the event (km/h)
max_speed	number	Maximum speed configured for the vehicle (km/h)
step	string	Duration or step description of the overspeed event
pois	string	Nearby radar/speed-camera POIs (when radars=true). Empty string when disabled or no POIs found

speed vs max_speed

speed is the actual speed recorded during the event. max_speed is the speed limit configured in the vehicle's settings — useful for comparing how much the driver exceeded their own vehicle's threshold.

Example Response

{
  "success": true,
  "data": [
    {
      "device_name": "Sedan C-310",
      "person_name": "Ana Lopez",
      "datetime": "2026-03-07T14:22:15",
      "address": "Ruta 1 km 45, San Jose",
      "speed": 118,
      "max_speed": 110,
      "step": "4m 05s",
      "pois": "Radar Km 44 (320m)"
    },
    {
      "device_name": "Truck A-101",
      "person_name": "Carlos Martinez",
      "datetime": "2026-03-07T16:10:33",
      "address": "Av. Italia 2800, Montevideo",
      "speed": 95,
      "max_speed": 80,
      "step": "1m 12s",
      "pois": ""
    }
  ],
  "meta": {
    "total": 23,
    "limit": 50,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
BAD_REQUEST	400	Missing required headers
VALIDATION_ERROR	400	Invalid params: missing dates, range > 31 days, speed_threshold outside 1–300, limit > 100
UNAUTHORIZED	401	Invalid or expired JWT / API Key
FORBIDDEN	403	User lacks APICLI_RPTAVL_VELOCIDAD permission
RATE_LIMITED	429	Exceeded 10 req/min
INTERNAL_ERROR	500	Unexpected server error

---

Related

• Trips Report — Individual trip records with speed data
• Kilometers Report — Distance and consumption aggregates
• Rate Limits — Sliding window details
• Pagination — Standard pagination parameters