Generated Alerts Report

System-generated alerts with event details, location, speed, temperature, and notification channel.

GET/apidev/v1/reports/general/generated-alerts

PermissionAPICLI_RPTGRAL_ALERTAS

Rate Limit10 req/min

Cache300s

Max Range31 days

---

Request

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 from startdate.
devices	string	No	All visible	Comma-separated device IDs. Max 500.
alert_ids	string	No	—	Comma-separated alert configuration IDs. Max length 200.
event_group	string	No	—	Event group filter. Max length 200.
limit	integer	No	25	Number of records per page (1–100).
offset	integer	No	0	Number of records to skip for pagination.

---

Code Examples

cURL

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

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/general/generated-alerts?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${token}`,
      'X-API-Key': apiKey,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

Python

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/general/generated-alerts",
    headers={"Authorization": f"Bearer {token}", "X-API-Key": api_key, "tenant": TENANT},
    params={"startdate": "2026-03-01T00:00:00", "enddate": "2026-03-15T23:59:59", "limit": 25},
)
data = response.json()

---

Response

Response Fields

Field	Type	Description
alert_name	string	Alert configuration name.
event_group	string	Event group/category.
event_code	string	Event code.
generated_at	string | null	Generation timestamp.
sent_at	string | null	Notification sent timestamp.
device_name	string	Vehicle name.
driver_name	string	Driver name.
address	string	Location address.
latitude	number | null	Latitude.
longitude	number | null	Longitude.
speed	number	Speed at event (km/h).
temperature	number	Temperature at event.
channel	string	Notification channel.

Example Response

{
  "success": true,
  "data": [
    {
      "alert_name": "Urban Speed Limit",
      "event_group": "speed_violation",
      "event_code": "SPD-001",
      "generated_at": "2026-03-05T14:22:00",
      "sent_at": "2026-03-05T14:22:05",
      "device_name": "Unit-105",
      "driver_name": "Carlos Martinez",
      "address": "Av. Reforma 1234, Col. Centro",
      "latitude": 19.4326,
      "longitude": -99.1332,
      "speed": 95,
      "temperature": 22.5,
      "channel": "email"
    },
    {
      "alert_name": "Cold Chain Max Temperature",
      "event_group": "temperature_alarm",
      "event_code": "TEMP-003",
      "generated_at": "2026-03-06T06:15:00",
      "sent_at": "2026-03-06T06:15:02",
      "device_name": "Unit-310",
      "driver_name": "Miguel Torres",
      "address": "Central de Abastos, Iztapalapa",
      "latitude": 19.3900,
      "longitude": -99.1500,
      "speed": 0,
      "temperature": 8.5,
      "channel": "sms"
    }
  ],
  "meta": {
    "total": 2,
    "limit": 25,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
BAD_REQUEST	400	Missing required headers.
VALIDATION_ERROR	400	Invalid parameters (e.g. date range exceeds 31 days).
UNAUTHORIZED	401	Invalid or expired JWT / API Key.
FORBIDDEN	403	User lacks required permission.
RATE_LIMITED	429	Exceeded 10 req/min.
INTERNAL_ERROR	500	Unexpected server error.

---

Related

• Authentication
• Pagination
• Rate Limits
• Error Handling