Events

The Events API provides a log of system-level activity across your estate — connectivity changes, billing alerts, platform notifications, and more.

Base URL

https://app.zentarinetworks.com

---

List Events

GET /api/events

Returns a paginated list of events.

Query Parameters

Parameter	Type	Default	Description
searchTerm	string	—	Filter by event title or description
date	datetime	—	Filter by date
severity	integer	—	Filter by severity code
type	integer	—	Filter by event type code
page	integer	1	Page number
pageSize	integer	100	Results per page (1–100)

Use GET /api/events/metadata to get the valid values for severity and type.

Response

{
  "data": [
    {
      "id": 1001,
      "type": 2,
      "severity": 1,
      "title": "Pool overage threshold reached",
      "description": "Pool 'IoT Fleet UK' has exceeded 80% of its data allocation.",
      "date": "2025-06-01T14:32:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 100,
    "totalItems": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}

---

Get Event

GET /api/events/{id}

Path Parameters

Parameter	Type	Description
id	integer	Event ID

---

Event Object

Field	Type	Description
id	integer	Event ID
type	integer	Event type code — see /api/events/metadata
severity	integer	Severity code — see /api/events/metadata
title	string	Short event title
description	string	Detailed description
date	datetime	Event timestamp

---

Event Metadata

GET /api/events/metadata

Returns human-readable labels for event type and severity codes.

Response

{
  "type": [
    { "code": 0, "description": "..." },
    { "code": 1, "description": "..." }
  ],
  "severty": [
    { "code": 0, "description": "..." },
    { "code": 1, "description": "..." }
  ]
}

note

The field name severty is as returned by the API (matches the spec exactly).