Samoa IoT Platform

Integrate your systems with the SAMOA connected-equipment platform — telemetry, alerts, stock and fleet status over a token-secured REST API.

Get started in 2 minutes

Open the web application and create an API token under API / Integrations.
Call any endpoint with Authorization: Bearer <token>:

curl https://api.linter-iot-stg.icent.digital/v1/devices \
  -H "Authorization: Bearer lit_xxxxxxxxxxxxxxxx"

Devices and telemetry

Device identity, list filters, readings history and the device-model catalog. Read the guide →

MQTT

Mutual-TLS broker, telemetry and command topics, and the HTTP fallback for publishing readings. Read the guide →

Device commands

Packets sent from the platform to a device: templates, statuses and the confirmation protocol. Read the guide →

Alerts and notifications

Threshold rules per equipment type, alert lifecycle and email notification rules. Read the guide →

QR labels and binding

Factory labels with the commercial chain, factory registration, the scan flow and the approval queue. Read the guide →

Authentication

API tokens, JWT login, optional email 2FA and how tenancy scoping works. Read the guide →

Errors and limits

The error envelope, stable error codes, rate limits and pagination. Read the guide →

Environments and URLs Staging endpoints, local development URLs and the API versioning policy.

Self-hosted with Docker Run the whole platform on your own Linux machine, with simulated devices.

Interactive API reference Every endpoint, with a try-it client that runs requests from your browser.