Use Cases/Guides

Proactive Alerting and Automated Workflow Guide

Overview

The SitePro API enables developers to monitor site conditions in near real time and trigger automated workflows when defined thresholds or events occur. By combining live data access with external integrations, teams can move from reactive monitoring to proactive operations.

This guide outlines how to detect conditions using SitePro data and automatically trigger alerts, notifications, or downstream system actions.

Request Sensor Live Data

GET https://platform.sitepro.com/v1/edge/live/site/sensors/{siteId}

curl -X GET
  -H "Authorization: Bearer <JWT_token>"
  "https://platform.sitepro.com/v1/edge/live/site/sensors/{siteId}"

Path parameter

Parameter	Required
Description	siteId
Yes	The ID of the site you want live sensor readings for. Obtained from GET /v1/sites.

Note: No request body is needed. Pass only the siteId in the URL path and your Bearer token in the Authorization header.

Response

Returns an array of objects - one per sensor at the site. Sensors are included regardless of whether they have a recent reading; check lastUpdatedStats to determine data freshness.

[
  {
    "siteSensorId": 1989,
    "siteId": 78894,
    "name": "Analog Flowmeter",
    "currentReading": 0,
    "currentValue": 0,
    "lastUpdatedStats": "2025-07-16T16:14:59.020Z",
    "lastLogDate": "2025-07-16T16:06:27.673Z",
    "active": true,
    "unitId": 11,
    "units": "mA",
    "convertedUnitId": 38,
    "convertedUnits": "bbl/day",
    "latitude": null,
    "longitude": null
  },
  {
    "siteSensorId": 2095,
    "siteId": 78894,
    "name": "Injection 1 Discharge PT",
    "currentReading": 4.037842374303807,
    "currentValue": 7.095445181963811,
    "lastUpdatedStats": "2026-06-23T15:51:52.236Z",
    "lastLogDate": "2024-04-12T08:20:38.676Z",
    "active": true,
    "unitId": 11,
    "units": "mA",
    "convertedUnitId": 3,
    "convertedUnits": "psi",
    "latitude": null,
    "longitude": null
  }
]

Response fields

Field	Description
siteSensorId	Unique ID of the sensor at this site
siteId	ID of the site this sensor belongs to
name	Display name of the sensor
currentReading	The raw sensor reading in the sensor's native units (units field)
currentValue	The converted reading in human-readable units (convertedUnits field)
lastUpdatedStats	Timestamp of the most recent stats update for this sensor
lastLogDate	Timestamp of the most recent data log entry recorded for this sensor
active	Whether the sensor is currently active
unitId	Internal ID for the native unit of measurement
units	Native unit of the raw reading (e.g. mA)
convertedUnitId	Internal ID for the converted unit of measurement
convertedUnits	Converted unit displayed to users (e.g. psi, bbl/day)
latitude	GPS latitude of the sensor, if configured
longitude	GPS longitude of the sensor, if configured

How It Works

Retrieve Live Data
Use SitePro APIs to pull current sensor readings, site status, or activity
Define Rules or Thresholds
Establish conditions (e.g., pressure limits, inactivity windows)
Evaluate Conditions
Continuously check incoming data against your rules
Trigger Actions
When conditions are met, initiate workflows in external systems
Log and Monitor
Track triggered events for visibility and auditing

What to Monitor

Sensor Data

Pressure, flow rate, level, temperature
Threshold breaches or abnormal values

Site Activity

Equipment activity frequency or gaps
Unexpected inactivity or delays

System Health

Missing or stale data
Device or edge connectivity issues

How Integrators Use This

Automated Alerts

Send notifications via email, SMS, or messaging platforms (e.g., Slack)
Escalate issues based on severity or duration

CMMS (Computerized Maintenance Management System) & Work Order Integration

Automatically create maintenance tickets when thresholds are exceeded
Assign work orders based on site, asset, or issue type

Operational Monitoring Dashboards

Highlight active issues in real time
Track triggered alerts and resolution status

Exception Management

Detect and flag anomalies or unexpected behavior
Route issues to the appropriate teams or systems

Competitive Site Benchmarking Guide