Table of Contents

SIA Protocol - Alarm Integration

TetherX supports receiving alarm messages from alarm panels using the SIA (Security Industry Association) protocol. This enables integration with burglary, fire, and access control alarm systems to automatically create Events and notify users.

What is SIA?

SIA is a standardized digital communication protocol developed by the Security Industry Association. Alarm panels use SIA to send alarm data to central monitoring stations (CMS) using human-readable ASCII text and short codes.

How it works:

  • 2-letter event codes identify alarm type (BA = Burglary Alarm, MA = Medical Alarm, PA = Panic Alarm)
  • 3-digit zone numbers identify specific locations or devices
  • Checksums ensure data integrity during transmission
  • Supports multiple formats: SIA8, SIA20, SIA DC-09 with modern encryption (AES-128)

Tip: SIA protocol creates a common language for alarm systems, fire panels, and access control systems to communicate with monitoring centers and security platforms like TetherX.

Compatible Alarm Panels

TetherX supports SIA protocol from commercial alarm panels when configured with an IP communicator module. This sends alarm messages directly to TetherX over the network for real-time event creation and notifications.

Common supported panels:

  • Honeywell Galaxy
  • Texecom (via IP communicator, unless using serial integration)
  • DSC PowerSeries
  • Bosch Solution 3000/6000
  • Vanderbilt Vigo/Vigor
  • Inim Electronics
  • Risco LightSys

Tip: Check with your alarm panel manufacturer for IP communicator module availability and SIA protocol configuration support. Different panels require different communicator modules.

API Endpoint

The SIA integration endpoint accepts alarm messages from alarm panels in standard SIA format:

  • Endpoint: /api/v3/alarms/sia_event
  • Method: POST
  • Content-Type: application/json

SIA Format

SIA events use the following structure:

{
  "alarm": {
    "sia_event": "[#900001|Nti22:02/ri01/PA1001|APanic Alarm]"
  },
  "token": "YOUR_TIMELINE_API_TOKEN"
}

SIA String Components

  • #900001 - Site/transmitter ID (matches transmitter_id in TetherX)
  • Nti - Timestamp of event
  • ri01 - Area/partition identifier (e.g., 'ri1' for Area 1)
  • PA - Event type code (e.g., PA = Panic Alarm, BA = Burglary Alarm, MA = Medical Alarm)
  • 1001 - Zone number identifying the specific device or location
  • A - ASCII text description of the alarm type

Authentication

  • Get your API token from your Timeline account

    • API token location
  • Steps:

    1. Click your user avatar (top right)
    2. Select API Details tab
    3. Copy your API token
    4. Include in all API requests

Example Request

curl "https://brand.timeline.is/api/v3/alarms/sia_event" \
  --data '{"alarm":{"sia_event":"[#900001|Nti22:02/ri01/PA1001|APanic Alarm]"},"token":"YOUR_API_TOKEN"}' \
  --request POST \
  -H "Content-Type: application/json"

Response

Successful requests return:

{"status":"ok"}

How It Works

When an alarm panel sends a SIA message to TetherX:

  • Parse and process: SIA string is parsed to extract site ID, event type, and zone

    • SIA parsing
  • Create event: Alarm Events are automatically created and categorized by event type (burglary, fire, medical, panic, etc.)

    • Event response in dashboard
  • Notify users: Email notifications sent to integrator and admin users with alarm details

    • Email notification example
  • Integration: Combine with Cameras for simultaneous video capture when alarms trigger

Notifications

Integrator and admin users receive email notifications for all incoming SIA alarm events, allowing rapid response to security incidents.

  • API - Full API reference
Last updated: January 17, 2026