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

Overview

Returns the alerts the system generated over the selected period, each with its event details, the device and driver involved, the location and speed at the moment, any temperature reading, and the channel the notification was sent through. Use it to audit triggered alerts and how they were delivered.

Device filter — devices limits results to specific units
Alert filter — alert_ids narrows results to specific alert configurations
Event grouping — event_group filters by event category

Request

Request Headers

Every request to a protected endpoint requires these headers:

Header	Required	Description
`Authorization`	Yes	Bearer token obtained from the Login endpoint. Format: `Bearer <token>`
`X-API-Key`	Yes	Company integration key provided during onboarding. Format: `gtk_xxx...`
`tenant`	Yes	Your assigned tenant domain (default: `geotareas.com`) — always send your assigned tenant
`Content-Type`	Conditional	`application/json` — required for `POST` and `PUT` requests

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
JavaScript
Python

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"

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();

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.
`elapsed_time`	string	Time spent inside the geofence that triggered the alert, already human-readable (e.g. `1h 05m`). Empty when the event is not geofence-based.
`geofences`	string	Geofences involved in the event, comma-separated.
`pois`	string	Points of interest involved in the event, comma-separated.
`sensor1_label`	string	Sensor 1 reading label. Empty when the company does not use sensor 1.
`sensor2_label`	string	Sensor 2 reading label. Empty when the company does not use sensor 2.
`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,
      "elapsed_time": "1h 05m",
      "geofences": "Deposito Central",
      "pois": "Estacion de servicio Ruta 1",
      "sensor1_label": "Puerta abierta",
      "sensor2_label": "",
      "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,
      "elapsed_time": "1h 05m",
      "geofences": "Deposito Central",
      "pois": "Estacion de servicio Ruta 1",
      "sensor1_label": "Puerta abierta",
      "sensor2_label": "",
      "channel": "sms"
    }
  ],
  "meta": {
    "total": 2,
    "limit": 25,
    "offset": 0
  }
}

Errors

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

Overview​

Request​

Request Headers​

Query Parameters​

Code Examples​

Response​

Response Fields​

Example Response​

Errors​

Related​