Skip to content

Smart Connect API

What is the Smart Connect API?

The Smart Connect API provides RESTful access to measurement data, alarm information, device metadata and status, locations and measuring objects stored in testo Smart Connect. It is intended for developers who want to programmatically retrieve and integrate data from their Smart Connect account.

The main things you can do with the API:

  • Retrieve measurement data from loggers and sensors
  • Fetch alarm data and status information
  • Access metadata about devices and their status
  • Retrieve locations corresponding to customers or measurement sites
  • Fetch measuring objects

Delivery Guarantee

The Smart Connect API follows an at-least-once delivery policy for measurements, alarms and device status payloads. Duplicated data can occur when loggers retransmit data to guarantee delivery to the cloud. If your workflow requires strictly unique entries, deduplicate the results using the uuid field present in each record.

Urgent Channel Mapping Notice

Some legacy devices expose channel metadata that differs from the equipment/alarm configuration with the physical values field and the physical extension Mapping Alarm Configuration and Devices:

  • Temperature - Product Temperature matches channel metadata one-to-one.
  • Temperature - Unknown in equipment alarms corresponds to Temperature - Air Temperature on device channels.
  • Door - Door Contact in equipment alarms is equivalent to Unknown - Door Contact on device channels.

De-duplicate or normalize these combinations when correlating equipment alarms with device channel metadata.

Base URL

The URL for this API is: https://data-api.REGION.ENV.smartconnect.testo.com

What Next?

We recommend reading the Authentication & Security chapter first if you are not yet familiar with how our APIs handle authentication. Otherwise, you can proceed directly to the API Reference to explore the available endpoints.