Messages & Events

API endpoints for SECS messages and equipment events.

Messages API

List Messages

bash

GET /api/v1/messages?equipment_id={id}&limit=100

Get Message

bash

GET /api/v1/messages/{id}

Send Message

bash

POST /api/v1/equipment/{id}/messages
Content-Type: application/json

{
  "stream": 1,
  "function": 13,
  "wait_for_reply": true,
  "data": {
    "MDLN": "FabConnect",
    "SOFTREV": "1.0.0"
  }
}

Events API

List Events

bash

GET /api/v1/events?equipment_id={id}&type=alarm&limit=100

Event Types

connection: Connection state changes
alarm: Alarm events
state: State machine transitions
message: SECS message events

Filtering

bash

GET /api/v1/events?
  equipment_id=eq_123&
  type=alarm&
  from=2025-12-01T00:00:00Z&
  to=2025-12-07T23:59:59Z&
  limit=100