---
title: "Get HOS clocks"
method: GET
path: "/fleet/hos/clocks"
tags: ["Hours of Service"]
---

# Get HOS clocks

`GET /fleet/hos/clocks`

## Request

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

Get the current HOS status for all drivers. Note that this includes inactive as well as active drivers. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getFleetHosLogsSummary). 

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

## Query parameters

- `tagIds` string[]
- `parentTagIds` string[]
- `driverIds` string[]
- `after` string
- `limit` integer

## Response `200`

List of current HOS clock information for the specified drivers.

- HosClocksResponse: Drivers HOS clocks and pagination info.
  - `data` HosClocksForDriver[], required: List of HOS clocks for the specified drivers.
    - `clocks` HosClocks: Remaining durations and start times (where applicable) for various HOS rules. See [this page](https://www.samsara.com/fleet/eld-compliance/hours-of-service) for more information on HOS rules.
      - `break` HosBreak: Remaining durations for the HOS rest break requirement.
        - `timeUntilBreakDurationMs` number: Time until the driver has a required break in milliseconds.
      - `cycle` HosCycle: Remaining durations and start time for the HOS driving cycle.
        - `cycleRemainingDurationMs` number: Remaining on duty or driving time the driver has in the current cycle in milliseconds. For property-carrying drivers, this is the amount of time the driver can be on duty or driving before hitting the 60/70-hour limit in 7/8 days.
        - `cycleStartedAtTime` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
        - `cycleTomorrowDurationMs` number: Remaining on duty or driving time the driver has available tomorrow in milliseconds. For property-carrying drivers this is calculated based on the 60/70-hour limit in 7/8 days rule.
      - `drive` HosDrive: Remaining durations for the HOS driving shift limits.
        - `driveRemainingDurationMs` number: Remaining driving time the driver has in the current shift in milliseconds. For property-carrying drivers, this is the amount of time the driver can drive before hitting the 11-hour limit.
      - `shift` HosShift: Remaining durations and start time for the HOS on duty shift limits.
        - `shiftRemainingDurationMs` number: Remaining on duty or driving time the driver in the current shift in milliseconds. For property-carrying drivers, this is the amount of time the driver can be on duty or driving before hitting the 14-hour limit.
    - `currentDutyStatus` CurrentDutyStatus: The current HOS status type and time the driver started being in this status.
      - `hosStatusType` 'offDuty' | 'sleeperBed' | 'driving' | 'onDuty' | 'yardMove' | 'personalConveyance': The Hours of Service status type. If the driver app is disconnected, an empty string will be returned. To reconnect the app and return updated values, drivers should have the app open with good cell service. Valid values: `offDuty`, `sleeperBed`, `driving`, `onDuty`, `yardMove`, `personalConveyance`.
    - `currentVehicle` VehicleTinyResponse: A minified vehicle object.
      - `ExternalIds` object: The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object.
      - `id` string: ID of the vehicle.
      - `name` string: Name of the vehicle.
    - `driver` DriverTinyResponse: A minified driver object.
      - `id` string: ID of the driver.
      - `name` string: Name of the driver.
    - `violations` HosViolations: Durations the driver has been in violation of HOS rules. See [this page](https://www.samsara.com/fleet/eld-compliance/hours-of-service) for more information on HOS rules.
      - `cycleViolationDurationMs` number: Time since the driver has surpassed the driving cycle duration limit in milliseconds. For property-carrying drivers, this is the amount of time the driver has been on duty or driving past the 60/70-hour limit in 7/8 days.
      - `shiftDrivingViolationDurationMs` number: Time since the driver has surpassed the driving shift duration limit in milliseconds. For property-carrying drivers, this is the amount of time the driver has been driving past the 11-hour limit.
  - `pagination` PaginationResponse, required: Pagination parameters.
    - `endCursor` string, 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

- `default`: Error 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)