Data API (Parquet)
Bulk data export in Apache Parquet format for analytics and data lakes
APIs
Haltian IoT API documentation - Service API, Stream API, and Data API
Overview
Haltian IoT provides multiple APIs for different data access patterns and use cases.
Which API Should I Use?
| API | Protocol | Best for |
|---|---|---|
| Service API | GraphQL | Device management, queries, configuration |
| Stream API | MQTT | Real-time event streaming |
| Data API | Parquet | Bulk export, analytics (Alpha) |
Most integrations start with the Service API for device discovery, then add the Stream API for live event subscriptions or the Data API for analytics workloads. The APIs are complementary — use one or combine several depending on your needs.
Service API
Query devices, read measurements, and manage configuration from your backend.
Stream API
Receive sensor events in real time as they happen — occupancy, environment, state changes.
Data API (Alpha)
Export large datasets in Parquet format for data warehouses, BI tools, or analytics pipelines.
Binary Passthrough
In addition to the cloud APIs above, Haltian IoT gateways support binary passthrough — delivering raw Wirepas device messages directly to a local MQTT broker without cloud processing. This is ideal for installations requiring low-latency access, data sovereignty, or air-gapped operation.
Binary passthrough is a gateway-level feature, not a cloud API. For configuration and setup details, see:
- Gateway Binary Passthrough — Local MQTT raw data delivery (Beta)
- Cloud Binary Passthrough — Raw data via Haltian IoT Cloud MQTT (Beta)
Service API
GraphQL API for Haltian IoT device management and data access
Stream API
MQTT streaming API for real-time Haltian IoT device data
Measurement Types Reference
Complete reference of all Haltian IoT measurement types verified against production schema