Developer API v1

Autosnavix API Documentation

Build your own apps on top of Autosnavix. Stream live GPS, read history, control engine cut-off, manage alerts, and receive webhooks — the same capabilities as our mobile app.

Open Developer DashboardAPI Discovery JSON
Auth

Send your API key on every request:

X-API-Key: prefix.secret
Base URL
https://api.autosnavix.com/api/v1
Access
Request access in the dashboard. An admin must approve before you can create keys.
Quick start
From zero to first location in a few minutes.
  1. Sign in → Developer API → Request access.
  2. Wait for admin approval (Admin → Developer Approvals).
  3. Create an API key and copy it once.
  4. Call the API with the key header.
curl -s https://api.autosnavix.com/api/v1/devices \\
  -H "X-API-Key: YOUR_PREFIX.YOUR_SECRET"

curl -s https://api.autosnavix.com/api/v1/devices/IMEI/location \\
  -H "X-API-Key: YOUR_PREFIX.YOUR_SECRET"

curl -s -X POST https://api.autosnavix.com/api/v1/devices/IMEI/commands \\
  -H "X-API-Key: YOUR_PREFIX.YOUR_SECRET" \\
  -H "Content-Type: application/json" \\
  -d '{"command":"STOP_ENGINE"}'
REST endpoints
Feature parity with the Autosnavix mobile experience.
GET/api/v1/API discovery (scopes, events, base URL)
GET/api/v1/meDeveloper profile & subscription
GET/api/v1/devicesList devices you can accessdevices:read
GET/api/v1/devices/:imeiDevice + vehicle detailsdevices:read
GET/api/v1/devices/:imei/locationLatest GPS positiongps:read
GET/api/v1/devices/:imei/positions?start&endRaw GPS track pointsgps:read
GET/api/v1/devices/:imei/history?start&endDaily trip summarieshistory:read
GET/api/v1/devices/:imei/settingsAlert & parking settingssettings:read
PUT/api/v1/devices/:imei/settingsUpdate parking/speed/distance alertssettings:write
GET/api/v1/devices/:imei/featuresPlan feature flags for devicefeatures:read
GET/api/v1/devices/:imei/smsRecent SMS logssms:read
POST/api/v1/devices/:imei/commandsSTOP_ENGINE, RESUME_ENGINE, RESTART_*commands:write
POST/api/v1/devices/:imei/share-locationCreate live share linkshare:write
POST/api/v1/devices/:imei/share-location/stopStop live sharingshare:write
GET/api/v1/vehiclesList your vehiclesvehicles:read
Webhooks
Register a URL in the developer dashboard. We POST JSON in real time and sign the body with HMAC-SHA256.
gps.updatesms.receivedalert.speedalert.distancealert.parkingcommand.queued*
Headers:
  Content-Type: application/json
  X-Autosnavix-Event: gps.update
  X-Autosnavix-Timestamp: 1710000000000
  X-Autosnavix-Signature: <hmac_sha256_hex>

Body:
{
  "event": "gps.update",
  "timestamp": 1710000000000,
  "payload": { ...device telemetry... }
}

// Node.js verification example
const crypto = require('crypto');
const expected = crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(rawBodyString)
  .digest('hex');
const ok = expected === req.headers['x-autosnavix-signature'];
Settings body (PUT)
{
  "enableParkingMode": true,
  "areaParkingLat": 45.5,
  "areaParkingLng": -73.6,
  "enableSpeedAlert": true,
  "speedLimit": 90,
  "enableDistanceAlert": true,
  "distanceLimit": 200,
  "areaPointLat": 45.5,
  "areaPointLng": -73.6,
  "emailEnabled": true,
  "emailAddresses": ["ops@example.com"],
  "smsEnabled": false,
  "smsNumbers": []
}
    API Documentation | Autosnavix