Alerts API

Access telematics safety alerts.

List Alerts

Retrieve safety alerts from dashcam and telematics devices.

GET /api/alerts

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number
limit	integer	No	Items per page
vehicle_id	string	No	Filter by vehicle
driver_id	string	No	Filter by driver
type	string	No	Filter by alert type
status	string	No	Filter: new, reviewed, dismissed

Response

{
  "count": 12,
  "items": [
    {
      "id": "alert-uuid",
      "type": "harsh_braking",
      "vehicle_id": "...",
      "driver_id": "...",
      "driver_name": "John Doe",
      "location": {
        "lat": 34.0522,
        "long": -118.2437,
        "address": "I-10, Los Angeles, CA"
      },
      "speed": 55,
      "status": "new",
      "created_at": "2025-11-20T14:30:00Z"
    }
  ]
}

GET/api/alerts

API Key

Query Parameters

page

limit

vehicle_id

type

status

---

Get Alert Types

List all available alert types.

GET /api/alerts/types

GET/api/alerts/types

API Key

---

Get Alert Details

Get detailed information including video/photo attachments.

GET /api/alerts/{alert_id}

Path Parameters

Parameter	Type	Description
alert_id	string (UUID)	The alert's unique identifier

GET/api/alerts/{alert_id}

API Key

Path Parameters

alert_id