---
title: "Get fuel and energy efficiency driver reports."
method: GET
path: "/fleet/reports/drivers/fuel-energy"
tags: ["Fuel and Energy"]
---

# Get fuel and energy efficiency driver reports.

`GET /fleet/reports/drivers/fuel-energy`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/reports/drivers/fuel-energy`
- Auth: HTTP bearer

Get fuel and energy efficiency driver reports for the requested time range.

 <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 Fuel & Energy** under the Fuel & Energy 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

- `startDate` string, required
- `endDate` string, required
- `driverIds` string[]
- `tagIds` string
- `parentTagIds` string
- `after` string

## Response `200`

OK response.

- FuelEnergyGetFuelEnergyDriverReportsResponseBody
  - `data` FuelEnergyDriverReportDataObjectResponseBody, required: Dictionary containing summarized driver report data.
    - `driverReports` FuelEnergyDriverReportObjectResponseBody[], required: List of summarized driver reports.
      - `distanceTraveledMeters` number, double, required: Meters traveled over the given time range.
      - `driver` GoaDriverTinyResponseResponseBody, required: A minified driver object. This object is only returned if the route is assigned to the driver.
        - `externalIds` object: A map of external ids
        - `id` string, required: ID of the driver
        - `name` string: Name of the driver
      - `efficiencyMpge` number, double, required: Efficiency in MPG or MPGE over the given time range. For fuel vehicles this will be provided in MPG, for hybrid and electric vehicles this will be provided in MPGE. MPG/MPGE values are provided based on US gallons.
      - `energyUsedKwh` number, double: Kilowatt-hours of energy used over the given time range. Only provided for hybrid and electric vehicles.
      - `engineIdleTimeDurationMs` integer: Milliseconds of engine idle time over the given time range. Only provided for fuel and hybrid vehicles.
      - `engineRunTimeDurationMs` integer: Milliseconds of engine run time over the given time range. Only provided for fuel and hybrid vehicles.
      - `estCarbonEmissionsKg` number, double: Estimated kilograms of carbon emissions over the given time range. Only provided for fuel and hybrid vehicles.
      - `estFuelEnergyCost` FuelEnergyCostResponseResponseBody, required: Estimated cost of fuel and energy over the given time range.
        - `amount` number, double, required: Amount of the currency.
        - `currencyCode` string, required: Type of the currency.
      - `fuelConsumedMl` number, double: Milliliters of fuel consumed over the given time range. Only provided for fuel and hybrid vehicles.
  - `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)