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

The Equipment API from Samsara — 8 operation(s) for equipment.

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

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

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

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

Paths & Operations 8

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

Equipment 8
GET
/fleet/equipment
List All Equipment
listEquipment 4 params → 200default
GET
/fleet/equipment/locations
Get Most Recent Locations for All Equipment
getEquipmentLocations 4 params → 200default
GET
/fleet/equipment/locations/feed
Follow Feed of Equipment Locations
getEquipmentLocationsFeed 4 params → 200default
GET
/fleet/equipment/locations/history
Get Historical Equipment Locations
getEquipmentLocationsHistory 6 params → 200default
GET
/fleet/equipment/stats
Get Most Recent Stats for All Equipment
getEquipmentStats 5 params → 200default
GET
/fleet/equipment/stats/feed
Follow a Feed of Equipment Stats
getEquipmentStatsFeed 5 params → 200default
GET
/fleet/equipment/stats/history
Get Historical Equipment Stats
getEquipmentStatsHistory 7 params → 200default
GET
/fleet/equipment/{id}
Retrieve a Unit of Equipment
getEquipment 1 param → 200default

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are EquipmentStatsListResponse_data (13 properties), EquipmentStatsResponse_data (12 properties), Equipment (7 properties), EquipmentStatsGps (7 properties). Each schema is shown below with its type and property counts.

EquipmentLocationsResponse_data
object
A unit of equipment and its most recent location.
3 properties 3 required
time
string
UTC timestamp in RFC 3339 format. Example: 2020-01-27T07:06:25Z.
EquipmentLocationsListResponse
object
A time-series of equipment locations and pagination information
2 properties 2 required
EquipmentObdEngineState
object
Engine state reading from on-board diagnostics.
2 properties 2 required
Equipment
object
An equipment object.
7 properties 1 required
AssetLocationHeading
number
Heading of the asset in degrees.
tagTinyResponse
object
A minified tag object
3 properties
standardErrorResponse
object
Error response
2 properties
EquipmentEngineState
object
[DEPRECATED] Please use either gatewayEngineStates or obdEngineStates.
2 properties 2 required
EquipmentGatewayJ1939EngineSeconds
object
Engine seconds reading from the J1939/CAT cable.
2 properties 2 required
EquipmentStatsGps
object
GPS location of equipment.
7 properties 3 required
EquipmentEngineSeconds
object
[DEPRECATED] Please use either gatewayEngineSeconds or obdEngineSeconds.
2 properties 2 required
EquipmentLocationsListResponse_data
object
A unit of equipment and its time-series of location events.
3 properties 3 required
EquipmentLocation
object
Location reading.
5 properties 3 required
Equipment_installedGateway
object
2 properties
EquipmentGpsOdometerMeters
object
GPS odometer reading.
2 properties 2 required
EquipmentListResponse
object
List of all equipment objects, and pagination information.
2 properties 2 required
EquipmentTime
string
UTC timestamp of the time the data point was generated by the equipment, in RFC3339 format.
EquipmentStatsResponse
object
The most recent equipment stats and pagination information
2 properties 2 required
carrierProposedAssignmentDriverAllOf2ExternalIds
object
The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object.
reverseGeo
object
Reverse geocoded information.
1 property
EquipmentLocationsResponse
object
The most recent equipment locations and pagination information
2 properties 2 required
EquipmentGatewayEngineSeconds
object
Engine seconds reading from the aux/digio cable.
2 properties 2 required
addressTinyResponse
object
Address book entry, if one exists
2 properties
EquipmentId
string
Unique Samsara ID for the equipment.
EquipmentName
string
Name of the equipment.
EquipmentStatsResponse_data
object
A unit of equipment and its most recent stat.
12 properties 2 required
paginationResponse
object
Pagination parameters.
2 properties 2 required
EquipmentStatsListResponse
object
A time-series of equipment stats and pagination information
2 properties 2 required
EquipmentFuelPercent
object
Fuel percent reading.
2 properties 2 required
EquipmentStatsListResponse_data
object
A unit of equipment and its time-series of stats events.
13 properties 2 required
EquipmentEngineRpm
object
Engine RPM reading.
2 properties 2 required
EquipmentGatewayEngineState
object
Engine state reading from the aux/digio cable.
2 properties 2 required
AssetLocationSpeed
number
GPS speed of the asset in miles per hour.
EquipmentResponse
object
A response containing an equipment object.
1 property 1 required
EquipmentObdEngineSeconds
object
Engine seconds reading from on-board diagnostics.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-equipment-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 Equipment 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.