Exporting data

Who can do this: viewers, operators and organization administrators — anyone with a role in the service's organization.

Pulse exports a service's readings as a CSV file. This is the only bulk export in Pulse; it is per service and per time window.

Export from the service page

1. Open the service page.
2. In Trends, choose the window you want: click a range button, or enter From and To and click Apply range.
3. Click ⬇ Export CSV (tooltip: "Download raw telemetry for this window as CSV"). Your browser downloads the file.

The export covers exactly the window the charts are showing.

The Trends toolbar with the 30d range selected and the Export CSV button highlighted.

Export by address

You can also open the export address directly, or save it as a bookmark:

• /services/<id>/export?range=7d
• /services/<id>/export?start=2026-09-01T00:00&end=2026-09-07T23:59

Parameter	Meaning
range	One of 1h, 4h, 12h, 1d, 7d, 30d, 365d, ending now. If you give no parameters at all, 30d is used.
start and end	An explicit window in the form YYYY-MM-DDTHH:MM, read in your profile timezone. Both must be given. An end in the future is clamped to now. If start is not earlier than end, or either cannot be read, the export falls back to range. When both start/end and range are given, start/end win.

There is no limit on the window length.

What the file contains

The file is UTF-8 with a byte-order mark, so spreadsheet applications show units such as °C correctly when you open it directly. One row per reading, ordered by time (oldest first) and then by channel name.

Column	Meaning
time_utc	Time of the reading in UTC, ISO 8601 with offset, for example 2026-09-07T14:05:32+00:00.
time_local (<timezone>)	The same time in your profile timezone, formatted YYYY-MM-DD HH:MM:SS. The header names the timezone, for example time_local (America/Vancouver).
device_eui	The identifier of the device that sent the reading.
channel	The channel name on the device, for example temperature.
metric_label	The label your administrator gave the channel in the service mapping, or the channel name if none.
value	The reading as a number. Empty if no value was recorded.
unit	The unit configured for the channel, or empty.

Which channels are included

Every channel mapped to the service that appears on the service page. Battery channels and the internal setpoint and state channels used by percentage-based limits are not included.

Calibrated, not raw

value is the reading after the channel's calibration (raw × scale + offset) was applied — the same number Pulse charts and evaluates against limits. The uncalibrated sensor value is not exported. Readings recorded before a calibration was set keep their original values. See Calibration.

No downsampling

Unlike the charts, the export always contains every reading in the window, whatever its length. A long window on a busy service produces a large file.

Text cells and spreadsheet formulas

A text cell (device identifier, channel, label or unit) that begins with =, +, -, @, a tab or a carriage return is written with a leading apostrophe (') so that spreadsheet applications treat it as text rather than a formula. Remove the apostrophe if you need the exact original text.

File name

<service-name>_<YYYYMMDD>_<YYYYMMDD>.csv — the service name with any character other than letters, digits, _ and - replaced by -, followed by the first and last dates of the window in UTC. For example Freezer-12_20260831_20260907.csv.

How far back you can export

Readings are kept for five years. Windows that reach further back return only the readings still held.

If the export does not work

What happens	Why
You are sent to the sign-in page	You are not signed in. Sign in and try again.
The response is "Service not found or not authorized"	The service does not exist, belongs to an organization you have no role in, or has been archived. Archived services cannot be exported, even by someone who kept the address; an organization administrator can restore the service first (see Archiving and restoring services).
The file has only the header row	There are no readings in the window, or the service has no mapped channels.

Tip

To find the window you need before exporting, use the From / To fields on the service page and check the chart, then click ⬇ Export CSV.