---
title: "Get all driver HOS daily logs"
method: GET
path: "/fleet/hos/daily-logs"
tags: ["Hours of Service"]
---

# Get all driver HOS daily logs

`GET /fleet/hos/daily-logs`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/hos/daily-logs`
- Auth: HTTP bearer

Get summarized daily Hours of Service charts for the specified drivers.

The time range for a log is defined by the `driver`'s `eldDayStartHour`. This value is configurable per driver.

The `startDate` and `endDate` parameters indicate the date range you'd like to retrieve daily logs for. A daily log will be returned if its `startTime` is on any of the days within in this date range (inclusive of `startDate` and `endDate`).

**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.

If you are using the legacy version of this endpoint and looking for its documentation, you can find it [here](https://www.samsara.com/api-legacy#operation/getFleetDriversHosDailyLogs).

 <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>).

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>
 

 **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.

## Query parameters

- `driverIds` string[]
- `startDate` string
- `endDate` string
- `tagIds` string
- `parentTagIds` string
- `driverActivationStatus` 'active' | 'deactivated'
- `after` string
- `expand` 'vehicle'

## Response `200`

OK response.

- HosDailyLogsGetHosDailyLogsResponseBody
  - `data` HosDailyLogsObjectResponseBody[], required: List of drivers and their HOS daily logs data.
    - `distanceTraveled` DistanceTraveledObjectResponseBody: The distance traveled information of the log.
      - `driveDistanceMeters` integer: Distance driven in meters, rounded to two decimal places.
      - `personalConveyanceDistanceMeters` integer: Distance driven for personal conveyance, rounded to two decimal places.
      - `yardMoveDistanceMeters` integer: Distance driven for yard moves, rounded to two decimal places.
    - `driver` DriverWithTimezoneEldSettingsObjectResponseBody, required: The driver the log applies to.
      - `eldSettings` EldSettingsObjectResponseBody: The driver's ELD settings.
        - `rulesets` DriverRulesetObjectResponseBody[]: The driver's ELD rulesets and overrides.
          - `break` 'Property (off-duty/sleeper)' | 'Explosives/HazMat (on-duty)': The rest break required setting of the ELD ruleset applied to this driver. Valid values: `Property (off-duty/sleeper)`, `Explosives/HazMat (on-duty)`
          - `cycle` 'USA 60 hour / 7 day' | 'USA 70 hour / 8 day' | 'AK 80 hour / 8 day' | 'AK 70 hour / 7 day' | 'CA 80 hour / 8 day' | 'CA 112 hour / 8 day' | 'FL 80 hour / 8 day' | 'FL 70 hour / 7 day' | 'NE 80 hour / 8 day' | 'NE 70 hour / 7 day' | 'NC 80 hour / 8 day' | 'NC 70 hour / 7 day' | 'OK 70 hour / 8 day' | 'OK 60 hour / 7 day' | 'OR 80 hour / 8 day' | 'OR 70 hour / 7 day' | 'SC 80 hour / 8 day' | 'SC 70 hour / 7 day' | 'TX 70 hour / 7 day' | 'WI 80 hour / 8 day' | 'WI 70 hour / 7 day' | 'Canada South Cycle 1 (70 hour / 7 day)' | 'Canada South Cycle 2 (120 hour / 14 day)' | 'Canada North Cycle 1 (80 hour / 7 day)' | 'Canada North Cycle 2 (120 hour / 14 day)': The cycle of the ELD ruleset applied to this driver. Valid values: `USA 60 hour / 7 day`, `USA 70 hour / 8 day`, `AK 80 hour / 8 day`, `AK 70 hour / 7 day`, `CA 80 hour / 8 day`, `CA 112 hour / 8 day`, `FL 80 hour / 8 day`, `FL 70 hour / 7 day`, `NE 80 hour / 8 day`, `NE 70 hour / 7 day`, `NC 80 hour / 8 day`, `NC 70 hour / 7 day`, `OK 70 hour / 8 day`, `OK 60 hour / 7 day`, `OR 80 hour / 8 day`, `OR 70 hour / 7 day`, `SC 80 hour / 8 day`, `SC 70 hour / 7 day`, `TX 70 hour / 7 day`, `WI 80 hour / 8 day`, `WI 70 hour / 7 day`, `Canada South Cycle 1 (70 hour / 7 day)`, `Canada South Cycle 2 (120 hour / 14 day)`, `Canada North Cycle 1 (80 hour / 7 day)`, `Canada North Cycle 2 (120 hour / 14 day)`
          - `jurisdiction` string: The jurisdiction of the ELD ruleset applied to this driver. These are specified by either `CS` or `CN` for Canada South and Canada North, respectively, or the ISO 3166-2 postal code for the supported state or territory.
          - `restart` '34-hour Restart' | '24-hour Restart' | '36-hour Restart' | '72-hour Restart': The restart of the ELD ruleset applied to this driver. Valid values: `34-hour Restart`, `24-hour Restart`, `36-hour Restart`, `72-hour Restart`
          - `shift` 'US Interstate Property' | 'US Interstate Passenger': The shift of the ELD ruleset applied to this driver. Valid values: `US Interstate Property`, `US Interstate Passenger`
      - `externalIds` object: A map of external ids
      - `id` string, required: ID of the driver
      - `name` string, required: Name of the driver
      - `timezone` string: Home terminal timezone, in order to indicate what time zone should be used to calculate the ELD logs. Driver timezones use [IANA timezone database](https://www.iana.org/time-zones) keys (e.g. `America/Los_Angeles`, `America/New_York`, `Europe/London`, etc.). You can find a mapping of common timezone formats to IANA timezone keys [here](https://unicode.org/cldr/charts/latest/supplemental/zone_tzid.html).
    - `dutyStatusDurations` DutyStatusDurationObjectResponseBody: The currently applied duty status durations on the driver's log.
      - `activeDurationMs` integer: Duration the driver was active for in the log period in milliseconds.
      - `driveDurationMs` integer: Duration the driver was driving for in the log period in milliseconds.
      - `offDutyDurationMs` integer: Duration the driver was off duty for in the log period in milliseconds.
      - `onDutyDurationMs` integer: Duration the driver was on duty for in the log period in milliseconds.
      - `personalConveyanceDurationMs` integer: Duration the driver was driving for personal conveyance for in the log period in milliseconds.
      - `sleeperBerthDurationMs` integer: Duration the driver was in their sleeper berth for in the log period in milliseconds.
      - `waitingTimeDurationMs` integer: Duration the driver was waiting for in the log period in milliseconds.
      - `yardMoveDurationMs` integer: Duration the driver was driving for yard moves for in the log period in milliseconds.
    - `endTime` string, required: The end time of the daily log in RFC 3339 format. This will be calculated using timezone of the driver.
    - `logMetaData` LogMetaDataObjectResponseBody: The metadata of the log.
      - `adverseDrivingClaimed` boolean: Whether the driver has claimed the [Adverse Driving Exemption](https://kb.samsara.com/hc/en-us/articles/360047336792-Adverse-Driving-Exemption) for this HOS day chart.
      - `bigDayClaimed` boolean: Whether the driver has claimed the [Big Day Exemption](https://kb.samsara.com/hc/en-us/articles/360057113891-16-Hour-Short-Haul-Exemption-Big-Day-) for this HOS day chart.
      - `carrierFormattedAddress` string: The address of the carrier used for this HOS chart.
      - `carrierName` string: The name of the carrier used for this HOS chart.
      - `carrierUsDotNumber` integer: The US DOT number of the carrier used for this HOS chart.
      - `certifiedAtTime` string: The time this log was certified in RFC 3339 format.
      - `homeTerminalFormattedAddress` string: The address of the Home Terminal used for this HOS chart.
      - `homeTerminalName` string: The name of the Home Terminal used for this HOS chart.
      - `isCertified` boolean: Whether this HOS day chart was certified by the driver.
      - `isUsShortHaulActive` boolean: Whether the driver has the 150 air-mile Short Haul Exemption active for this HOS day chart.
      - `shippingDocs` string: List of shipping document names associated with the driver for the day. This field maps to Shipping ID in the dashboard.
      - `trailerNames` string[]: List of trailer names associated with the driver for the day. If a trailer was associated with a log through the driver app the trailer name will be the trailer ID.
      - `vehicles` VehicleResponseResponseBody[]: List of vehicles associated with the driver for the day.
        - `assetType` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle': The type of the asset. Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle`
        - `externalIds` object: A map of external ids
        - `id` string: ID of the vehicle
        - `licensePlate` string: The license plate of the vehicle.
        - `name` string: Name of the vehicle
        - `vehicleVin` string: The VIN of the vehicle.
    - `pendingDutyStatusDurations` PendingDutyStatusDurationsObjectResponseBody: What the duty status durations on the driver’s log would be if all pending carrier edits are accepted by the driver.
      - `activeDurationMs` integer: Duration the driver was active for in the log period in milliseconds.
      - `driveDurationMs` integer: Duration the driver was driving for in the log period in milliseconds.
      - `offDutyDurationMs` integer: Duration the driver was off duty for in the log period in milliseconds.
      - `onDutyDurationMs` integer: Duration the driver was on duty for in the log period in milliseconds.
      - `personalConveyanceDurationMs` integer: Duration the driver was driving for personal conveyance for in the log period in milliseconds.
      - `sleeperBerthDurationMs` integer: Duration the driver was in their sleeper berth for in the log period in milliseconds.
      - `waitingTimeDurationMs` integer: Duration the driver was waiting for in the log period in milliseconds.
      - `yardMoveDurationMs` integer: Duration the driver was driving for yard moves for in the log period in milliseconds.
    - `startTime` string, required: The start time of the daily log in RFC 3339 format. This will be calculated using timezone of the driver.
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)