Samsara currently has two generations of APIs. The latest generation uses RFC 3339 format to represent timestamps as strings. The first-generation 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 first-generation 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).