TL;DR: Surfact’s API allows you to pull real-time sensor data from Emma Smart Trackers into your own systems. It’s easy to use, reliable, and designed to make your cold-chain monitoring, temperature compliance and trailer tracking smarter. Contact [email protected] to get your ClientID and Access Token today.
🚀 Getting Started with the Surfact API
Surfact’s API gives your product and engineering teams seamless access to real-time and historical data from Emma Smart Trackers. Whether you’re building a dashboard, automating cold-chain compliance, or integrating sensor data into your platform, our API is built to empower data-driven decision-making.
🌟 Why Use the Surfact API?
With a few simple calls, your team can:
Gain instant visibility into the condition and location of goods in transit.
Power proactive decision-making by integrating temperature, location data and more directly into your systems.
Reduce risk by setting up alerts and analytics based on live sensor values.
Automate workflows around asset tracking, cold-chain monitoring, and compliance reporting.
🔧 Overview
Here are the most common endpoints you’ll need:
Action | Endpoint | What It Does |
🔄 Get last values | GET /devices/{DEVICE_LABEL} | Latest sensor readings from a device |
📦 List all devices | GET /devices/ | View all devices under your account |
📍 Get single device | GET /devices/{DEVICE_LABEL}/ | Metadata & data links for a device |
📊 Single variable data | GET /variables/{VARIABLE_ID}/ | Metadata + most recent value |
🕒 Historical values | GET /variables/{VARIABLE_ID}/values/ | Past values of a variable |
📆 Values by date range | GET /variables/{VARIABLE_ID}/values/?start=X&end=Y | Time-based filtering |
🧭 Get latest value | GET /variables/{VARIABLE_ID}/values/latest/ | Most recent single value |
Each endpoint supports secure access using your API token and returns clean, JSON-formatted responses.
🔐 Example: Fetch Latest Data from a Device
curl -X GET "https://api.surfact.com/api/v1.6/devices/{DEVICE_LABEL}" \ -H "X-Auth-Token: YOUR_TOKEN" \ -H "Content-Type: application/json"This call returns the most recent values (e.g., temperature, humidity) from the specified tracker.
Example response:
{
"temperature": {
"value": 23.5,
"timestamp": 1678371834000,
"context": { "unit": "C" },
"created_at": 1678371834179
},
"humidity": {
"value": 56.8,
"timestamp": 1678371834000,
"context": null,
"created_at": 1678371834179
}
}
See further examples in API doc:
✅ Contact us today at [email protected] to get your ClientID and access token set up.
By embedding Surfact’s IoT data directly into your systems you unlock:
Operational efficiency — fewer manual checks, less downtime.
Customer transparency — real-time updates and audit trails.
Predictive insights — act before issues escalate.