How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Samsara Fuel API

The Fuel API from Samsara — 2 operation(s) for fuel.

Samsara Fuel API is one of 90 APIs that Samsara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Fuel. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 2 operations across 2 paths, and defines 30 schemas. It is described by OpenAPI 3.0.1, at version 2024-11-18.

Requests are made against 2 base URLs: https://api.samsara.com/, https://api.eu.samsara.com/.

2 operations 2 paths 30 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2024-11-18
Base URL
https://api.samsara.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Samsara Fuel API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Fuel 2
GET
/fleet/reports/drivers/fuel-energy
Get Fuel and Energy Efficiency Driver Reports.
getFuelEnergyDriverReports 6 params → 200401404405429500501502
GET
/fleet/reports/vehicles/fuel-energy
Get Fuel and Energy Efficiency Vehicle Reports.
getFuelEnergyVehicleReports 7 params → 200401404405429500501502

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are FuelEnergyDriverReportObjectResponseBody (9 properties), FuelEnergyVehicleReportObjectResponseBody (9 properties), FuelEnergyVehicleObjectResponseBody (4 properties), GoaDriverTinyResponseResponseBody (3 properties). Each schema is shown below with its type and property counts.

FuelEnergyCostResponseResponseBody
object
Estimated cost of fuel and energy over the given time range.
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
FuelEnergyDriverReportDataObjectResponseBody
object
Dictionary containing summarized driver report data.
1 property 1 required
FuelEnergyGetFuelEnergyDriverReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
GoaPaginationResponseResponseBody
object
Pagination parameters.
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsResponseBody
object
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
FuelEnergyVehicleReportDataObjectResponseBody
object
Dictionary containing summarized vehicle report data.
1 property 1 required
FuelEnergyGetFuelEnergyDriverReportsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsResponseBody
object
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
FuelEnergyVehicleObjectResponseBody
object
A minified vehicle object.
4 properties 1 required
GoaDriverTinyResponseResponseBody
object
A minified driver object. This object is only returned if the route is assigned to the driver.
3 properties 1 required
FuelEnergyVehicleReportObjectResponseBody
object
A summary of this vehicle's fuel and energy data.
9 properties 4 required
FuelEnergyGetFuelEnergyVehicleReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
FuelEnergyDriverReportObjectResponseBody
object
A summary of this driver's fuel and energy data.
9 properties 4 required
FuelEnergyGetFuelEnergyDriverReportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-fuel-api-openapi.yml Raw ↑

Other APIs Samsara publishes across the network.

Samsara Activity API
Samsara Addresses API
Samsara Aemp API
Samsara Applications API
Samsara Assets API
Samsara Assignments API
Samsara Attributes API
Samsara Audit API
Samsara Beta A P Is API
Samsara Camera API
Samsara Cameras API
Samsara Cargo API
Where this information came from

This is an independent, third-party profile of Samsara Fuel API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.