---
title: "[beta] Get driver HOS ELD events"
method: GET
path: "/beta/fleet/hos/drivers/eld-events"
tags: ["Beta APIs"]
---

# \[beta\] Get driver HOS ELD events

`GET /beta/fleet/hos/drivers/eld-events`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/beta/fleet/hos/drivers/eld-events`
- Auth: HTTP bearer

Get all HOS ELD events in a time range, grouped by driver. Attributes will be populated depending on which ELD Event Type is being returned.

 <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

- `startTime` string, required
- `endTime` string, required
- `driverIds` string[]
- `tagIds` string
- `parentTagIds` string
- `driverActivationStatus` 'active' | 'deactivated'
- `after` string
- `limit` integer

## Response `200`

OK response.

- HosEldEventsGetHosEldEventsResponseBody
  - `data` HosDriversEldEventObjectResponseBody[], required: List of drivers and their ELD event objects data.
    - `driverActivationStatus` 'active' | 'deactivated', required: A value indicating whether the driver is active or deactivated. Valid values: `active`, `deactivated`
    - `eldEvents` HosEldEventObjectResponseBody[], required: List of ELD event objects.
      - `accumulatedVehicleMeters` integer: The accumulated meters in the given ignition power on cycle.
      - `elapsedEngineHours` number, double: The elapsed time in the engine's operation in the given ignition power on cycle.
      - `eldEventCode` integer, required: A dependent attribute on `eldEventType` that specifies the nature of the event, as defined in the ELD Mandate [section 7.20](https://www.ecfr.gov/cgi-bin/retrieveECFR?gp=1&ty=HTML&h=L&mc=true&=PART&n=pt49.5.395#ap49.5.395_138.a). Valid values: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`
      - `eldEventRecordOrigin` integer: An attribute for the event record indicating whether it is automatically recorded, or edited, entered or accepted by the driver, requested by another authenticated user, or assumed from unidentified driver profile, as defined in the ELD Mandate [section 7.22](https://www.ecfr.gov/cgi-bin/retrieveECFR?gp=1&ty=HTML&h=L&mc=true&=PART&n=pt49.5.395#ap49.5.395_138.a). Valid values: `1`, `2`, `3`, `4`
      - `eldEventRecordStatus` integer: An attribute for the event record indicating whether an event is active or inactive and further, if inactive, whether it is due to a change or lack of confirmation by the driver or due to a driver's rejection of change request, as defined in the ELD Mandate [section 7.23](https://www.ecfr.gov/cgi-bin/retrieveECFR?gp=1&ty=HTML&h=L&mc=true&=PART&n=pt49.5.395#ap49.5.395_138.a). Valid values: `1`, `2`, `3`, `4`
      - `eldEventType` integer, required: An attribute specifying the type of ELD event, as defined in the ELD Mandate [section 7.25](https://www.ecfr.gov/cgi-bin/retrieveECFR?gp=1&ty=HTML&h=L&mc=true&=PART&n=pt49.5.395#ap49.5.395_138.a). Valid values: `1`, `2`, `3`, `4`, `5`, `6`, `7`
      - `location` HosEldEventLocationObjectResponseBody
        - `city` string: The best effort city for the latitude and longitude.
        - `eldLocation` string: Relative location to the city, village, or town with population of 5,000 or greater.
        - `latitude` number, double: The latitude of the location.
        - `longitude` number, double: The longitude of the location.
        - `state` string: The best effort state for the latitude and longitude.
      - `malfunctionDiagnosticCode` 'P' | 'E' | 'T' | 'L' | 'R' | 'S' | 'O' | '1' | '2' | '3' | '4' | '5' | '6': A code that further specifies the underlying malfunction or data diagnostic event, as defined in the ELD Mandate [section 7.34](https://www.ecfr.gov/cgi-bin/retrieveECFR?gp=1&ty=HTML&h=L&mc=true&=PART&n=pt49.5.395#ap49.5.395_138.a). Valid values: `P`, `E`, `T`, `L`, `R`, `S`, `O`, `1`, `2`, `3`, `4`, `5`, `6`
      - `remark` HosEldEventRemarkObjectResponseBody
        - `comment` string, required: The content of the remark.
        - `locationDescription` string, required: The location description entered by the user
        - `time` string, required: The time in RFC 3339 format at which the remark was created.
      - `time` string, required: A time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
      - `totalEngineHours` number, double: The aggregated time of a vehicle's engine's operation since its inception.
      - `totalVehicleMeters` integer: The total meters recorded for the vehicle.
      - `vehicle` GoaVehicleTinyResponseResponseBody: A minified vehicle object. This object is only returned if the route is assigned to the vehicle.
        - `externalIds` object: A map of external ids
        - `id` string: ID of the vehicle
        - `name` string: Name of the vehicle
    - `externalIds` object: A map of external ids
    - `id` string, required: ID of the driver.
    - `name` string, required: Name of the driver.
  - `pagination` GoaPaginationResponseResponseBody: 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)