Returns HOS logs between a given startTime and endTime. The logs can be further filtered using tags or by providing a list of driver IDs (including external IDs). The legacy version of this endpoint can be found at samsara.com/api-legacy.

Note: If data is still being uploaded from the Samsara Driver App, it may not be completely reflected in the response from this endpoint. The best practice is to wait a couple of days before querying this endpoint to make sure that all data from the Samsara Driver App has been uploaded.

<b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

To use this endpoint, select Read ELD Compliance Settings (US) under the Compliance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

{
  "data": [
    {
      "driver": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "hosLogs": [
        {
          "codrivers": [
            {
              "id": "88668",
              "name": "Susan Bob"
            }
          ],
          "hosStatusType": "offDuty",
          "logEndTime": "2020-01-27T07:06:25Z",
          "logRecordedLocation": {
            "latitude": 122.142,
            "longitude": -93.343
          },
          "logStartTime": "2020-01-27T07:06:25Z",
          "remark": "Lunch Break",
          "vehicle": {
            "ExternalIds": {
              "maintenanceId": "250020",
              "payrollId": "ABFS18600"
            },
            "id": "123456789",
            "name": "Midwest Truck #4"
          }
        }
      ]
    }
  ],
  "pagination": {
    "endCursor": "MjkY",
    "hasNextPage": true
  }
}