Samsara currently has two generations of APIs. The current set of APIs use RFC 3339 format to represent timestamps as strings. The legacy APIs present timestamps as the number of milliseconds since the Unix epoch (int64s).

📘

Timezones

Samsara returns both RFC 3339 and Unix timestamps in Coordinated Universal Time (UTC).

You may need to convert timestamps to/from UTC for your application.

Parameters that support RFC 3339 accept timezone offsets (e.g., 2020-11-02T00:00:00-08:00 to represent GMT-08:00). However the API *response will always be formatted in UTC.

RFC 3339

The current generation of Samsara APIs use the RFC 3339 format for timestamps. RFC 3339 is a string representation of date and time.

Here is a basic example:

2020-06-18T17:24:53Z

The above timestamp refers to June 18, 2020 5:24:53 PM in Coordinated Universal Time (UTC).

Unix timestamps

The legacy Samsara APIs express timestamps as milliseconds since the Unix epoch in UTC.

Here is a basic example:

1592501093000

The above timestamp refers to June 18, 2020 5:24:53 PM in Coordinated Universal Time (UTC).