API referenceTracker

Update Tracker

Push a GPS position for a tracker in the current company. Send the same device id on every update. Lockii stores the tracker as tracker_{companyId}_{id} and creates it on the first report. A position of 0,0, or outside -90 to 90 latitude and -180 to 180 longitude, is ignored and the previous coordinates stay in place. Pass lifetime kilometres as odometerKm or odometer when the device reports them. App connections need the booking:write or inventory:write scope.

PUT

/api/v1/tracker

PUT

/tracker

curl -X PUT "https://dash.lockii.app/api/v1/tracker" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "lat": 0,
  "lng": 0
}'

Authorization

x-api-key
string
header
API key from Settings → Integrations → API.
Authorization
string
header
The same API key, or an OAuth access token, sent as Authorization: Bearer.
api_key
string
query
API key query parameter.

Body

application/json

battery
number
Battery percentage from 0 to 100. Omitted reports store 100.
id
string
required
Device id from your GPS provider. Stored as tracker_{companyId}_{id}.
lat
any of
required
Latitude in decimal degrees, as a number or a numeric string.
lng
any of
required
Longitude in decimal degrees, as a number or a numeric string.
name
string
Display name. Omitted reports use Tracker {id}.
odometer
any of
Lifetime kilometres, as a number or a numeric string. Used when odometerKm is omitted.
odometerKm
any of
Lifetime kilometres, as a number or a numeric string.
speed
any of
Speed reported by the device.

Response

application/json

JSON result for this operation.

message
enum<string>
required
One of:
Tracker location updated

{
  "message": "Tracker location updated"
}

PUT

/tracker

curl -X PUT "https://dash.lockii.app/api/v1/tracker" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "lat": 0,
  "lng": 0
}'

{
  "message": "Tracker location updated"
}

- Introduction
- User MCP
- Customer MCP
- Booking API
- Building a Lockii App
- Login with Lockii
- Building a Marketplace App

Update Tracker - Lockii Help Center | Productlane

API referenceTracker

Update Tracker

PUT

/api/v1/tracker

PUT

/tracker

curl -X PUT "https://dash.lockii.app/api/v1/tracker" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "lat": 0,
  "lng": 0
}'

Authorization

x-api-key
string
header
API key from Settings → Integrations → API.
Authorization
string
header
The same API key, or an OAuth access token, sent as Authorization: Bearer.
api_key
string
query
API key query parameter.

Body

application/json

battery
number
Battery percentage from 0 to 100. Omitted reports store 100.
id
string
required
Device id from your GPS provider. Stored as tracker_{companyId}_{id}.
lat
any of
required
Latitude in decimal degrees, as a number or a numeric string.
lng
any of
required
Longitude in decimal degrees, as a number or a numeric string.
name
string
Display name. Omitted reports use Tracker {id}.
odometer
any of
Lifetime kilometres, as a number or a numeric string. Used when odometerKm is omitted.
odometerKm
any of
Lifetime kilometres, as a number or a numeric string.
speed
any of
Speed reported by the device.

Response

application/json

JSON result for this operation.

message
enum<string>
required
One of:
Tracker location updated

{
  "message": "Tracker location updated"
}

PUT

/tracker

curl -X PUT "https://dash.lockii.app/api/v1/tracker" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "lat": 0,
  "lng": 0
}'

{
  "message": "Tracker location updated"
}