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 Reports API

The Reports API from Samsara — 5 operation(s) for reports.

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

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

This API exposes 5 operations across 5 paths, and defines 71 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/.

5 operations 5 paths 71 schemas 5 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 Reports API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 5

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

Reports 5
GET
/fleet/reports/drivers/fuel-energy
Get Fuel and Energy Efficiency Driver Reports.
getFuelEnergyDriverReports 6 params → 200401404405429500501502
GET
/fleet/reports/ifta/jurisdiction
Get IFTA Jurisdiction Reports.
getIftaJurisdictionReports 8 params → 200401404405429500501502
GET
/fleet/reports/ifta/vehicle
Get IFTA Vehicle Reports.
getIftaVehicleReports 9 params → 200401404405429500501502
GET
/fleet/reports/vehicle/idling
Get Vehicle Idling Reports.
getVehicleIdlingReports 9 params → 200401404405429500501502
GET
/fleet/reports/vehicles/fuel-energy
Get Fuel and Energy Efficiency Vehicle Reports.
getFuelEnergyVehicleReports 7 params → 200401404405429500501502

Schemas 71

The contract defines 71 schemas that model the data the API accepts and returns. The most detailed are FuelEnergyVehicleReportObjectResponseBody (9 properties), FuelEnergyDriverReportObjectResponseBody (9 properties), IdlingReportEventResponseBody (7 properties), IftaJurisdictionReportDataObjectResponseBody (5 properties). Each schema is shown below with its type and property counts.

IdlingReportEventAddressResponseBody
object
Address where the idling event took place.
3 properties 3 required
FuelEnergyCostResponseResponseBody
object
Estimated cost of fuel and energy over the given time range.
2 properties 2 required
IdlingReportEventResponseBody
object
A summary of the idling event.
7 properties 7 required
FuelEnergyGetFuelEnergyVehicleReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
IftaJurisdictionSummaryObjectResponseBody
object
A summary of this jurisdiction's IFTA data.
4 properties 3 required
IdlingReportsGetVehicleIdlingReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
IFTAGetIftaJurisdictionReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
IFTAGetIftaVehicleReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
IFTAGetIftaJurisdictionReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
IFTAGetIftaVehicleReportsTooManyRequestsErrorResponseBody
object
Too many requests
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
IFTAGetIftaJurisdictionReportsResponseBody
object
1 property 1 required
FuelEnergyDriverReportDataObjectResponseBody
object
Dictionary containing summarized driver report data.
1 property 1 required
FuelEnergyGetFuelEnergyDriverReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
IFTAGetIftaJurisdictionReportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
GoaPaginationResponseResponseBody
object
Pagination parameters.
2 properties 2 required
IFTAGetIftaJurisdictionReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
IFTAGetIftaJurisdictionReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
IFTAGetIftaVehicleReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
IFTAGetIftaVehicleReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
IFTAGetIftaVehicleReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsResponseBody
object
2 properties 2 required
IFTAGetIftaVehicleReportsResponseBody
object
2 properties 2 required
GoaVehicleTinyResponseResponseBody
object
A minified vehicle object. This object is only returned if the route is assigned to the vehicle.
3 properties
FuelEnergyGetFuelEnergyDriverReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
FuelEnergyVehicleReportDataObjectResponseBody
object
Dictionary containing summarized vehicle report data.
1 property 1 required
IFTAGetIftaJurisdictionReportsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 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
IFTAGetIftaVehicleReportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
IFTAGetIftaVehicleReportsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
IftaJurisdictionReportDataObjectResponseBody
object
Dictionary containing summarized jurisdiction report data.
5 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
IFTAGetIftaJurisdictionReportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsResponseBody
object
2 properties 2 required
IftaReportTroubleshootingObjectResponseBody
object
IFTA report troubleshooting information.
4 properties 4 required
FuelEnergyVehicleObjectResponseBody
object
A minified vehicle object.
4 properties 1 required
IftaVehicleReportObjectResponseBody
object
A summary of this vehicle's IFTA data.
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
GoaDriverTinyResponseResponseBody
object
A minified driver object. This object is only returned if the route is assigned to the driver.
3 properties 1 required
IFTAGetIftaJurisdictionReportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
IFTAGetIftaJurisdictionReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
IdlingReportsGetVehicleIdlingReportsResponseBody
object
4 properties 4 required
IFTAGetIftaVehicleReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
FuelEnergyVehicleReportObjectResponseBody
object
A summary of this vehicle's fuel and energy data.
9 properties 4 required
IftaVehicleReportDataObjectResponseBody
object
Dictionary containing summarized vehicle report data.
5 properties 2 required
IFTAGetIftaJurisdictionReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
FuelEnergyGetFuelEnergyVehicleReportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
FuelEnergyGetFuelEnergyDriverReportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
IFTAGetIftaVehicleReportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
IFTAGetIftaVehicleReportsBadRequestErrorResponseBody
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
IdlingReportsGetVehicleIdlingReportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-reports-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 Reports 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.