Fuel Point Analytics API (Beta)

The Fuel Point Analytics API returns refuel detection data, allowing you to understand trends in refueling events and get contextual information regarding fuel events including vehicle class, vehicle vocation, and vehicle industry.

Purpose

Note: Fuel Point Analytics is currently in Beta testing until October 2026. To access and test this endpoint, contact Altitude support.

Altitude is testing a new module designed to measure the number of refuel events, Fuel Point Analytics. Leveraging Geotab's first-party telematics data, this module identifies refueling events by distinguishing them from general commercial vehicle stops at fuel stations. The module provides aggregated metrics on refueling frequency, dwell times, and vehicle classifications across specified zones and date ranges.

The Fuel Point Analytics API is accessed via the following REST endpoints. For full parameter and response documentation, see the Altitude API Guide:


Method	Endpoint	Description
`POST`	/api/v2/stop-analytics/fuel-point-analytics	Start a fuel point analytics job.
`GET`	/api/v2/stop-analytics/fuel-point-analytics/{id}	Get fuel point analytics results.
`GET`	/api/v2/stop-analytics/fuel-point-analytics/{id}/time-series	Get fuel point analytics time-series results.

Note: Python SDK method: client.stop_analytics.fuel_point_analytics(params).run()

Refuel Event Definition

A refuel event is identified when a commercial vehicle makes a stop at a fuel station that is attributed as a refueling stop rather than a general stop. Geotab's telematics data is used to distinguish refueling events from other stop types based on stop duration, location type, and vehicle behaviour patterns.