List a machine's signals
Return the raw sensor signals a machine exposes, with the public_id needed to read samples.
A signal is one sensor channel read by the machine, named after the physical quantity it
carries (current, count, product_count, cycle, energy, temperature,
pressure, ...). A machine can expose several signals with the same name; their
display_name tells them apart. Soft-deleted signals and signals without a kind are not listed.
description is in English by default; pass language=es for Spanish. A description with no
translation in the requested language is returned in English.
Path Parameters
The machine's uuid, as returned by GET /v1/machines.
uuidQuery Parameters
Language of each signal's description. Falls back to English.
"en"Value in
- "en"
- "es"
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/machines/497f6eca-6276-4993-bfeb-53cbbbba6f08/signals"{ "machine_uuid": "01748f7c-9688-7abc-8def-0123456789ab", "signals": [ { "public_id": "eb3ce6c7-ce7e-4638-a072-e5054706f601", "name": "string", "display_name": "string", "description": "string" } ]}Stops report POST
Return individual machine stops with their duration, cause and classification. This is the drill-down behind the downtime totals in the metrics report. `stopId` accepts the full comparison grammar, so a specific stop or a range of them can be pulled directly.
Read signal data GET
Return aggregated raw sensor points for one signal. Samples are bucketed before they are returned. The bucket width is `agg_period` x `agg_unit` (`agg_period=15`, `agg_unit=m` is a 15-minute bucket) and `agg_function` is how samples inside a bucket are reduced. By default points are returned as a `data` list of `{timestamp, value}` objects. Pass `transpose=true` to get two arrays of equal length instead, `timestamps` and `values`, where `values[i]` belongs to `timestamps[i]`. It carries the same points in a smaller body. Two limits are enforced and both reject the request rather than truncating the response: the window between `start_time` and `end_time` may not exceed **14 days**, and a query may not produce more than **10,000 points**. The defaults (`agg_unit=s`, `agg_period=1`) reach the point ceiling after under three hours, so most callers set them explicitly.