Use this page to find the right V2 endpoint for what you’re trying to do. Each section maps a common task to the endpoint that handles it.
All V2 endpoints use RESTful HTTP methods (GET, POST, PUT, DELETE) with parameters in the path or query string. V2 endpoints are at /api/v2/.... If you need the older V1 endpoints, switch to the V1 (Legacy) version in the version selector.
Tracking & location
Fleet & vehicle management
| I want to… | Endpoint |
|---|
| Get my company ID (needed for most calls) | GET /api/v2/companies |
| Search a set of vehicles | POST /api/v2/vehicles/list |
| Look up vehicle metadata by IMEI, ID, or VIN | GET /api/v2/vehicles/info |
| Convert an IMEI to a vehicle ID | GET /api/v2/vehicles/{imei}/device-ids |
| Rename a vehicle | PUT /api/v2/vehicles/{id}/name |
| Update a vehicle’s odometer reading | PUT /api/v2/vehicles/{id}/odometer |
Alerts
| I want to… | Endpoint |
|---|
| Retrieve recent alert records (speeding, geofence, etc.) | GET /api/v2/companies/{id}/alert-records |
| List alert configurations (definitions, not events) | GET /api/v2/companies/{id}/alerts |
| Mark one alert record as read or unread | PUT /api/v2/alerts/{id}/{date}/update-read-status |
| Mark all alert records for a company as read | PUT /api/v2/companies/{id}/set-all-alerts-read |
Vehicle health & diagnostics
| I want to… | Endpoint |
|---|
| Get battery voltage and predicted health for the fleet (select customers only) | GET /api/v2/battery-health |
| Get OBD-II / CAN fault codes from a vehicle | GET /api/v2/vehicles/{id}/engine-codes |
Webhooks
| I want to… | Endpoint |
|---|
| Subscribe to real-time alert events | POST /api/v2/webhooks |
| List my webhook subscriptions | GET /api/v2/webhooks |
| Update or delete a webhook | PUT /api/v2/webhooks/{id} · DELETE /api/v2/webhooks/{id} |
| Link an alert type to a webhook | POST /api/v2/webhooks/{id}/link-alert |
Authentication
| I want to… | Endpoint |
|---|
| Authenticate with an API key | POST /api/v2/authentication/token/api-key |
Most endpoints require a company ID. If you don’t have it, call GET /api/v2/companies first — the Id on the first result is your primary company ID.
