Traccar

App · 15 actions

Track your vehicles and devices in Traccar: see where each one is, get trips, stops and mileage reports, find events, manage devices and geofences, send commands, and start a workflow on a geofence visit, speeding, an alarm or a device going offline.

Actions

ActionWhat it does
Assign geofenceHave Traccar watch a geofence for some devices or a group, so entering and leaving it are recorded as events.
Create deviceAdd a device, such as a new vehicle's tracker, by the identifier it reports, with its group, category, details and speed limit.
Create geofenceDraw a geofence, such as a new job site: a circle round a point, or an area.
Delete deviceDelete a device, such as a sold vehicle's tracker, with its history of positions and events.
Delete geofenceDelete a geofence, such as a finished job site's. Past events there are kept.
Find eventsFind what happened in a period: geofences entered or left, speeding, alarms, ignition on or off and more, with the device, place and time.
Find positionsGet where a device was over a period, oldest first, with the distance it covered and its top speed: its route.
Get device locationFind where a vehicle or device is now: its latest position, address (when the server looks addresses up), speed, ignition, the geofences it's in and a map link.
Get stopsGet each place a device stood still and for how long, such as yesterday's.
Get summary reportGet each device's mileage, top and average speed, engine hours and fuel for a period, such as last month, with the fleet's totals.
Get tripsGet each drive from one stop to the next, such as yesterday's, with start and end times and places, distance, duration and speed, and the totals.
List devicesList your vehicles and other tracked devices with their status (online, offline, unknown), when each last reported and where it is now.
List geofencesList the geofences the connected user can see, or those assigned to one device, with their shapes.
Send commandSend a device a command its model supports, such as Single Reporting or Engine Stop.
Update deviceChange a device's name, identifier, group, category, details or speed limit, or disable or enable it.

Assign geofence

Have Traccar watch a geofence for some devices or a group, so entering and leaving it are recorded as events.

Inputs

GeofencegeofencetextRequired
The geofence: pick it, or give its name or ID.
Devicesdeviceslist
The devices to watch it for.
Groupgrouptext
Watch it for every device in this group.

Outputs

countnumber
How many devices and groups it was assigned to
deviceslist
The devices it was assigned to
geofencetext
Its name
geofence_idnumber
The geofence's ID
grouptext
The group it was assigned to; empty if none
Example output
{
  "count": 2,
  "devices": [
    "Van 1",
    "Van 2"
  ],
  "geofence": "Acme customer site",
  "geofence_id": 4,
  "group": ""
}

Create device

Add a device, such as a new vehicle's tracker, by the identifier it reports, with its group, category, details and speed limit.

Inputs

NamenametextRequired
What to call it, such as the vehicle's registration.
IdentifieridentifiertextRequired
The IMEI, serial number or other ID the device reports. It must match what the device sends.
Groupgrouptext
The group to put it in.
Categorycategorytext
What it is, which picks its icon on the map.One of: default, car, van, truck, bus, trailer, motorcycle, scooter, bicycle, tractor, and 11 more.
Phonephonetext
The SIM card's phone number.
Modelmodeltext
The vehicle or tracker model.
Contactcontacttext
Who to contact about it.
Speed limit (km/h)speed_limit_kmhnumber
Over this, Traccar records Speed limit exceeded.From 0 to 1000.

Outputs

categorytext
Its category, such as van or truck
contacttext
Its contact
disabledtrue/false
Whether it's disabled
grouptext
The group it's in; empty if none
group_idnumber
The group's ID; 0 if none
idnumber
The device's ID in Traccar
identifiertext
The IMEI, serial number or other ID the device reports
last_updatetext
When Traccar last heard from it (ISO 8601, UTC)
modeltext
Its model
nametext
Its name
phonetext
Its phone number
speed_limit_kmhnumber
Its speed limit in km/h; empty if none is set
statustext
online, offline or unknown (stopped reporting)
status_nametext
Its status as Traccar shows it: Online, Offline or Unknown
Example output
{
  "category": "van",
  "contact": "Sam Driver",
  "disabled": false,
  "group": "Depot vans",
  "group_id": 3,
  "id": 12,
  "identifier": "356307042441013",
  "last_update": "2026-11-06T09:15:02Z",
  "model": "Ford Transit",
  "name": "Van 1",
  "phone": "+15550100",
  "speed_limit_kmh": 80.0,
  "status": "online",
  "status_name": "Online"
}

Create geofence

Draw a geofence, such as a new job site: a circle round a point, or an area. Assign it to devices or a group to hear when they enter or leave it.

Inputs

NamenametextRequired
What to call the place.
Latitudelatitudenumber
A circle's centre: latitude, such as 51.5007.From -90 to 90.
Longitudelongitudenumber
A circle's centre: longitude, such as -0.1246.From -180 to 180.
Radius (metres)radius_mnumber
A circle's radius. Defaults to 200 metres.From 1 to 500000.
Areaareatext
Instead of a circle, the shape as Traccar writes it, latitude first: POLYGON ((51.51 -0.14, 51.512 -0.14, 51.512 -0.136, 51.51 -0.14)).
Descriptiondescriptiontext
What it's for.
Assign to devicesdeviceslist
Watch it for these devices.
Assign to groupgrouptext
Watch it for every device in this group.

Outputs

areatext
The shape as Traccar stores it (WKT, latitude first)
assigned_deviceslist
The devices it was assigned to
assigned_grouptext
The group it was assigned to; empty if none
descriptiontext
Its description
idnumber
The geofence's ID
latitudenumber
A circle's centre: latitude; empty for other shapes
longitudenumber
A circle's centre: longitude
map_linktext
A link that opens a circle's centre on a map
nametext
Its name
radius_mnumber
A circle's radius in metres
shapetext
circle, polygon or line
Example output
{
  "area": "CIRCLE (51.3762 -0.0982, 250)",
  "assigned_devices": [
    "Van 1"
  ],
  "assigned_group": "",
  "description": "Job 2291",
  "id": 4,
  "latitude": 51.3762,
  "longitude": -0.0982,
  "map_link": "https://www.google.com/maps/search/?api=1&query=51.3762,-0.0982",
  "name": "Acme customer site",
  "radius_m": 250.0,
  "shape": "circle"
}

Delete device

Delete a device, such as a sold vehicle's tracker, with its history of positions and events.

Inputs

DevicedevicetextRequired
The device: pick it, or give its name, identifier (IMEI) or ID.

Outputs

deletedtrue/false
Always true
idnumber
The deleted device's ID
identifiertext
Its identifier
nametext
Its name
Example output
{
  "deleted": true,
  "id": 12,
  "identifier": "356307042441013",
  "name": "Van 1"
}

Delete geofence

Delete a geofence, such as a finished job site's. Past events there are kept.

Inputs

GeofencegeofencetextRequired
The geofence: pick it, or give its name or ID.

Outputs

deletedtrue/false
Always true
idnumber
The deleted geofence's ID
nametext
Its name
Example output
{
  "deleted": true,
  "id": 4,
  "name": "Acme customer site"
}

Find events

Find what happened in a period: geofences entered or left, speeding, alarms, ignition on or off and more, with the device, place and time.

Inputs

Event typesevent_typeslist
Only these kinds of events. Leave blank for all.One or more of: geofenceEnter (Geofence entered), geofenceExit (Geofence exited), deviceOverspeed (Speed limit exceeded), alarm, ignitionOn (Ignition on), ignitionOff (Ignition off), deviceMoving (Device moving), deviceStopped (Device stopped), deviceInactive (Device inactive), maintenance (Maintenance required), and 7 more.
Devicesdeviceslist
Only these devices. Leave blank for every device (or the group's).
Groupgrouptext
Only the devices in this group, and in the groups inside it.
Geofencegeofencetext
Only events at this geofence.
Periodperiodtext
The time to cover. Filling in From makes it the time between From and To.One of: last_hour (Last hour), last_24_hours (Last 24 hours), today, yesterday, last_7_days (Last 7 days, with today), this_month (This month), last_month (Last month), custom (Between From and To). Default: last_24_hours.
Fromstartdate and time
Start here instead of at the period's start.
Toenddate and time
End here. Leave blank for now.
Time zonetime_zonetext
Where days start and end for the period, such as America/Chicago. Leave blank for the time zone set on the Traccar server, or UTC.
How manylimitnumber
The most events to list, the latest kept. Defaults to 200.From 1 to 2000.

Outputs

countnumber
How many are listed
eventslist
The events, oldest first
fromtext
When the report starts (ISO 8601, UTC)
grouptext
The group searched; empty if none was picked
has_moretrue/false
Whether there were more than the step lists (the latest are kept)
time_zonetext
The time zone the period was read in, such as Europe/London
totext
When the report ends (ISO 8601, UTC)
total_countnumber
How many happened in that time
Example output
{
  "count": 2,
  "events": [
    {
      "address": "Acme Ltd, Croydon",
      "alarm": "",
      "alarm_name": "",
      "details": "",
      "device": "Van 1",
      "device_id": 12,
      "geofence": "Acme customer site",
      "geofence_id": 4,
      "id": 5521,
      "identifier": "356307042441013",
      "latitude": 51.3762,
      "longitude": -0.0982,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.3762,-0.0982",
      "speed_kmh": 18.5,
      "speed_limit_kmh": null,
      "speed_mph": 11.5,
      "time": "2026-11-06T09:15:00Z",
      "type": "geofenceEnter",
      "type_name": "Geofence entered"
    },
    {
      "address": "A23, Coulsdon",
      "alarm": "",
      "alarm_name": "",
      "details": "",
      "device": "Van 1",
      "device_id": 12,
      "geofence": "",
      "geofence_id": 0,
      "id": 5530,
      "identifier": "356307042441013",
      "latitude": 51.3762,
      "longitude": -0.0982,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.3762,-0.0982",
      "speed_kmh": 104.2,
      "speed_limit_kmh": 80.0,
      "speed_mph": 64.7,
      "time": "2026-11-06T09:40:12Z",
      "type": "deviceOverspeed",
      "type_name": "Speed limit exceeded"
    }
  ],
  "from": "2026-11-05T10:00:00Z",
  "group": "",
  "has_more": false,
  "time_zone": "Europe/London",
  "to": "2026-11-06T10:00:00Z",
  "total_count": 2
}

Find positions

Get where a device was over a period, oldest first, with the distance it covered and its top speed: its route.

Inputs

DevicedevicetextRequired
The device: pick it, or give its name, identifier (IMEI) or ID.
Periodperiodtext
The time to cover. Filling in From makes it the time between From and To.One of: last_hour (Last hour), last_24_hours (Last 24 hours), today, yesterday, last_7_days (Last 7 days, with today), this_month (This month), last_month (Last month), custom (Between From and To). Default: last_24_hours.
Fromstartdate and time
Start here instead of at the period's start.
Toenddate and time
End here. Leave blank for now.
Time zonetime_zonetext
Where days start and end for the period, such as America/Chicago. Leave blank for the time zone set on the Traccar server, or UTC.
How manylimitnumber
The most positions to list, the earliest first. Defaults to 500.From 1 to 5000.

Outputs

countnumber
How many are listed
devicetext
The device's name
device_idnumber
The device's ID
distance_kmnumber
Distance covered in that time, in km
distance_minumber
Distance covered, in miles
fromtext
When the report starts (ISO 8601, UTC)
has_moretrue/false
Whether there were more than the step lists
max_speed_kmhnumber
Its top speed in that time, in km/h
positionslist
Its positions, oldest first
time_zonetext
The time zone the period was read in, such as Europe/London
totext
When the report ends (ISO 8601, UTC)
total_countnumber
How many it reported in that time
Example output
{
  "count": 2,
  "device": "Van 1",
  "device_id": 12,
  "distance_km": 0.18,
  "distance_mi": 0.11,
  "from": "2026-11-05T00:00:00Z",
  "has_more": false,
  "max_speed_kmh": 42.6,
  "positions": [
    {
      "address": "Westminster Bridge Road, London",
      "altitude": 12.0,
      "battery_level": 87.0,
      "course": 90.0,
      "fix_time": "2026-11-06T09:15:00Z",
      "ignition": "on",
      "latitude": 51.5007,
      "longitude": -0.1246,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.5007,-0.1246",
      "moving": true,
      "odometer_km": null,
      "position_id": 90211,
      "server_time": "2026-11-06T09:15:02Z",
      "speed_kmh": 42.6,
      "speed_mph": 26.5,
      "total_distance_km": 15230.42,
      "valid": true
    },
    {
      "address": "Parliament Square, London",
      "altitude": 12.0,
      "battery_level": 87.0,
      "course": 90.0,
      "fix_time": "2026-11-06T09:16:00Z",
      "ignition": "on",
      "latitude": 51.5021,
      "longitude": -0.126,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.5007,-0.1246",
      "moving": true,
      "odometer_km": null,
      "position_id": 90212,
      "server_time": "2026-11-06T09:15:02Z",
      "speed_kmh": 42.6,
      "speed_mph": 26.5,
      "total_distance_km": 15230.42,
      "valid": true
    }
  ],
  "time_zone": "Europe/London",
  "to": "2026-11-06T00:00:00Z",
  "total_count": 2
}

Get device location

Find where a vehicle or device is now: its latest position, address (when the server looks addresses up), speed, ignition, the geofences it's in and a map link.

Inputs

DevicedevicetextRequired
The device: pick it, or give its name, identifier (IMEI) or ID.

Outputs

addresstext
The address, if the server looks addresses up
altitudenumber
Altitude in metres
battery_levelnumber
Battery level in percent, if reported
coursenumber
Heading in degrees, 0 being north
devicetext
The device's name
device_idnumber
The device's ID
fix_timetext
When the position was taken (ISO 8601, UTC)
geofenceslist
The geofences it was inside
has_locationtrue/false
Whether it has reported a position yet
identifiertext
The device's identifier
ignitiontext
on or off; empty if the device doesn't report it
last_updatetext
When Traccar last heard from it (ISO 8601, UTC)
latitudenumber
Latitude
longitudenumber
Longitude
map_linktext
A link that opens the place on a map
movingtrue/false
Whether it was moving
odometer_kmnumber
The vehicle's odometer in km, if reported
position_idnumber
The position's ID
server_timetext
When Traccar received it (ISO 8601, UTC)
speed_kmhnumber
Speed in km/h
speed_mphnumber
Speed in mph
statustext
online, offline or unknown
status_nametext
Online, Offline or Unknown
total_distance_kmnumber
Distance travelled as Traccar counts it, in km
validtrue/false
Whether the device had a GPS fix
Example output
{
  "address": "Westminster Bridge Road, London",
  "altitude": 12.0,
  "battery_level": 87.0,
  "course": 90.0,
  "device": "Van 1",
  "device_id": 12,
  "fix_time": "2026-11-06T09:15:00Z",
  "geofences": [
    "Main depot"
  ],
  "has_location": true,
  "identifier": "356307042441013",
  "ignition": "on",
  "last_update": "2026-11-06T09:15:02Z",
  "latitude": 51.5007,
  "longitude": -0.1246,
  "map_link": "https://www.google.com/maps/search/?api=1&query=51.5007,-0.1246",
  "moving": true,
  "odometer_km": null,
  "position_id": 90211,
  "server_time": "2026-11-06T09:15:02Z",
  "speed_kmh": 42.6,
  "speed_mph": 26.5,
  "status": "online",
  "status_name": "Online",
  "total_distance_km": 15230.42,
  "valid": true
}

Get stops

Get each place a device stood still and for how long, such as yesterday's.

Inputs

Devicesdeviceslist
Only these devices. Leave blank for every device (or the group's).
Groupgrouptext
Only the devices in this group, and in the groups inside it.
Periodperiodtext
The time to cover. Filling in From makes it the time between From and To.One of: last_hour (Last hour), last_24_hours (Last 24 hours), today, yesterday, last_7_days (Last 7 days, with today), this_month (This month), last_month (Last month), custom (Between From and To). Default: yesterday.
Fromstartdate and time
Start here instead of at the period's start.
Toenddate and time
End here. Leave blank for now.
Time zonetime_zonetext
Where days start and end for the period, such as America/Chicago. Leave blank for the time zone set on the Traccar server, or UTC.

Outputs

countnumber
How many stops
fromtext
When the report starts (ISO 8601, UTC)
grouptext
The group reported on; empty if none was picked
stopslist
Each stop, earliest first
time_zonetext
The time zone the period was read in, such as Europe/London
totext
When the report ends (ISO 8601, UTC)
Example output
{
  "count": 1,
  "from": "2026-11-05T00:00:00Z",
  "group": "",
  "stops": [
    {
      "address": "Acme Ltd, Croydon",
      "device": "Van 1",
      "device_id": 12,
      "duration_minutes": 388.1,
      "end_time": "2026-11-05T15:10:00Z",
      "engine_hours": 0.1,
      "latitude": 51.3762,
      "longitude": -0.0982,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.3762,-0.0982",
      "start_time": "2026-11-05T08:41:55Z"
    }
  ],
  "time_zone": "Europe/London",
  "to": "2026-11-06T00:00:00Z"
}

Get summary report

Get each device's mileage, top and average speed, engine hours and fuel for a period, such as last month, with the fleet's totals.

Inputs

Devicesdeviceslist
Only these devices. Leave blank for every device (or the group's).
Groupgrouptext
Only the devices in this group, and in the groups inside it.
Periodperiodtext
The time to cover. Filling in From makes it the time between From and To.One of: last_hour (Last hour), last_24_hours (Last 24 hours), today, yesterday, last_7_days (Last 7 days, with today), this_month (This month), last_month (Last month), custom (Between From and To). Default: yesterday.
Fromstartdate and time
Start here instead of at the period's start.
Toenddate and time
End here. Leave blank for now.
Time zonetime_zonetext
Where days start and end for the period, such as America/Chicago. Leave blank for the time zone set on the Traccar server, or UTC.

Outputs

countnumber
How many devices
deviceslist
Each device's totals, by name
fromtext
When the report starts (ISO 8601, UTC)
grouptext
The group reported on; empty if none was picked
time_zonetext
The time zone the period was read in, such as Europe/London
totext
When the report ends (ISO 8601, UTC)
total_distance_kmnumber
All their distance together, in km
total_distance_minumber
All their distance together, in miles
total_engine_hoursnumber
All their engine hours together
Example output
{
  "count": 1,
  "devices": [
    {
      "average_speed_kmh": 34.1,
      "device": "Van 1",
      "device_id": 12,
      "distance_km": 46.82,
      "distance_mi": 29.09,
      "end_odometer_km": 15230.42,
      "engine_hours": 1.6,
      "max_speed_kmh": 96.3,
      "max_speed_mph": 59.8,
      "spent_fuel": 0.0,
      "start_odometer_km": 15183.6
    }
  ],
  "from": "2026-11-05T00:00:00Z",
  "group": "",
  "time_zone": "Europe/London",
  "to": "2026-11-06T00:00:00Z",
  "total_distance_km": 46.82,
  "total_distance_mi": 29.09,
  "total_engine_hours": 1.6
}

Get trips

Get each drive from one stop to the next, such as yesterday's, with start and end times and places, distance, duration and speed, and the totals. Over more than a day, Traccar's quicker report may leave top speeds at 0.

Inputs

Devicesdeviceslist
Only these devices. Leave blank for every device (or the group's).
Groupgrouptext
Only the devices in this group, and in the groups inside it.
Periodperiodtext
The time to cover. Filling in From makes it the time between From and To.One of: last_hour (Last hour), last_24_hours (Last 24 hours), today, yesterday, last_7_days (Last 7 days, with today), this_month (This month), last_month (Last month), custom (Between From and To). Default: yesterday.
Fromstartdate and time
Start here instead of at the period's start.
Toenddate and time
End here. Leave blank for now.
Time zonetime_zonetext
Where days start and end for the period, such as America/Chicago. Leave blank for the time zone set on the Traccar server, or UTC.

Outputs

countnumber
How many trips
fromtext
When the report starts (ISO 8601, UTC)
grouptext
The group reported on; empty if none was picked
time_zonetext
The time zone the period was read in, such as Europe/London
totext
When the report ends (ISO 8601, UTC)
total_distance_kmnumber
Their distance together, in km
total_distance_minumber
Their distance together, in miles
total_duration_minutesnumber
Their driving time together, in minutes
tripslist
Each trip, earliest first
Example output
{
  "count": 2,
  "from": "2026-11-05T00:00:00Z",
  "group": "",
  "time_zone": "Europe/London",
  "to": "2026-11-06T00:00:00Z",
  "total_distance_km": 46.82,
  "total_distance_mi": 29.09,
  "total_duration_minutes": 82.3,
  "trips": [
    {
      "average_speed_kmh": 35.3,
      "device": "Van 1",
      "device_id": 12,
      "distance_km": 23.41,
      "distance_mi": 14.55,
      "driver": "Sam Driver",
      "duration_minutes": 39.8,
      "end_address": "Acme Ltd, Croydon",
      "end_latitude": 51.3762,
      "end_longitude": -0.0982,
      "end_time": "2026-11-05T08:41:55Z",
      "max_speed_kmh": 96.3,
      "start_address": "Main depot, London",
      "start_latitude": 51.5007,
      "start_longitude": -0.1246,
      "start_time": "2026-11-05T08:02:10Z"
    },
    {
      "average_speed_kmh": 35.3,
      "device": "Van 1",
      "device_id": 12,
      "distance_km": 23.41,
      "distance_mi": 14.55,
      "driver": "Sam Driver",
      "duration_minutes": 42.5,
      "end_address": "Main depot, London",
      "end_latitude": 51.3762,
      "end_longitude": -0.0982,
      "end_time": "2026-11-05T15:52:30Z",
      "max_speed_kmh": 96.3,
      "start_address": "Acme Ltd, Croydon",
      "start_latitude": 51.5007,
      "start_longitude": -0.1246,
      "start_time": "2026-11-05T15:10:00Z"
    }
  ]
}

List devices

List your vehicles and other tracked devices with their status (online, offline, unknown), when each last reported and where it is now.

Inputs

Statusstatustext
Only devices with this status.One of: any, online, not_online (Offline or unknown), offline, unknown (Unknown (stopped reporting)). Default: any.
Groupgrouptext
Only the devices in this group, and in the groups inside it.
Name or identifiersearchtext
Only devices whose name or identifier contains this.

Outputs

countnumber
How many are listed
deviceslist
The devices, by name
offline_countnumber
How many are offline
online_countnumber
How many of the user's devices (in the group, if one was picked) are online
unknown_countnumber
How many have stopped reporting (status unknown)
Example output
{
  "count": 2,
  "devices": [
    {
      "address": "Westminster Bridge Road, London",
      "category": "van",
      "contact": "Sam Driver",
      "disabled": false,
      "group": "Depot vans",
      "group_id": 3,
      "id": 12,
      "identifier": "356307042441013",
      "last_update": "2026-11-06T09:15:02Z",
      "latitude": 51.5007,
      "location_time": "2026-11-06T09:15:00Z",
      "longitude": -0.1246,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.5007,-0.1246",
      "model": "Ford Transit",
      "name": "Van 1",
      "phone": "+15550100",
      "speed_kmh": 42.6,
      "speed_limit_kmh": 80.0,
      "status": "online",
      "status_name": "Online"
    },
    {
      "address": "Westminster Bridge Road, London",
      "category": "truck",
      "contact": "Sam Driver",
      "disabled": false,
      "group": "",
      "group_id": 0,
      "id": 14,
      "identifier": "356307042441099",
      "last_update": "2026-11-06T09:15:02Z",
      "latitude": 51.5007,
      "location_time": "2026-11-06T09:15:00Z",
      "longitude": -0.1246,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.5007,-0.1246",
      "model": "Ford Transit",
      "name": "Truck 7",
      "phone": "+15550100",
      "speed_kmh": 0.0,
      "speed_limit_kmh": 80.0,
      "status": "unknown",
      "status_name": "Unknown"
    }
  ],
  "offline_count": 0,
  "online_count": 1,
  "unknown_count": 1
}

List geofences

List the geofences the connected user can see, or those assigned to one device, with their shapes.

Inputs

Devicedevicetext
Only geofences assigned to this device itself (not through its group).

Outputs

countnumber
How many
geofenceslist
The geofences, by name
Example output
{
  "count": 2,
  "geofences": [
    {
      "area": "CIRCLE (51.3762 -0.0982, 250)",
      "description": "Job 2291",
      "id": 4,
      "latitude": 51.3762,
      "longitude": -0.0982,
      "map_link": "https://www.google.com/maps/search/?api=1&query=51.3762,-0.0982",
      "name": "Acme customer site",
      "radius_m": 250.0,
      "shape": "circle"
    },
    {
      "area": "POLYGON ((51.5 -0.13, 51.502 -0.13, 51.502 -0.12, 51.5 -0.13))",
      "description": "",
      "id": 1,
      "latitude": null,
      "longitude": null,
      "map_link": "",
      "name": "Main depot",
      "radius_m": null,
      "shape": "polygon"
    }
  ]
}

Send command

Send a device a command its model supports, such as Single Reporting or Engine Stop. A device that isn't connected gets it when it next reports.

Inputs

DevicedevicetextRequired
The device: pick it, or give its name, identifier (IMEI) or ID.
CommandcommandtextRequired
What to send. Which ones work depends on the device's model; Engine Stop cuts the engine, so use it only where that is safe.One of: custom (Custom Command), message, positionSingle (Single Reporting), engineStop (Engine Stop), engineResume (Engine Resume), alarmArm (Arm Alarm), alarmDisarm (Disarm Alarm), alarmDismiss (Dismiss Alarm), requestPhoto (Request Photo), getDeviceStatus (Get Device Status), getVersion (Get Version), rebootDevice (Reboot Device).
Texttexttext
For Custom Command, the exact text the device takes; for Message, the message to show.

Outputs

commandtext
The command's type, such as engineStop or custom
command_nametext
The command as Traccar shows it, such as Engine Stop
devicetext
The device's name
device_idnumber
The device's ID
idnumber
The command's ID in Traccar's queue; 0 when it went out at once
queuedtrue/false
Whether it's waiting for the device to connect
statustext
sent, or queued until the device next connects
Example output
{
  "command": "positionSingle",
  "command_name": "Single Reporting",
  "device": "Van 1",
  "device_id": 12,
  "id": 0,
  "queued": false,
  "status": "sent"
}

Update device

Change a device's name, identifier, group, category, details or speed limit, or disable or enable it. Only the fields you fill in change.

Inputs

DevicedevicetextRequired
The device: pick it, or give its name, identifier (IMEI) or ID.
Namenametext
A new name. Leave blank to keep it.
Identifieridentifiertext
The IMEI, serial number or other ID the device reports. It must match what the device sends. Leave blank to keep it.
Groupgrouptext
The group to put it in. Leave blank to keep it.
Categorycategorytext
What it is, which picks its icon on the map. Leave blank to keep it.One of: default, car, van, truck, bus, trailer, motorcycle, scooter, bicycle, tractor, and 11 more.
Phonephonetext
The SIM card's phone number. Leave blank to keep it.
Modelmodeltext
The vehicle or tracker model. Leave blank to keep it.
Contactcontacttext
Who to contact about it. Leave blank to keep it.
Speed limit (km/h)speed_limit_kmhnumber
Over this, Traccar records Speed limit exceeded. 0 removes it. Leave blank to keep it.From 0 to 1000.
Disableddisabledtext
Disable it (Traccar ignores what it sends) or enable it. Leave blank to keep it.One of: disabled, enabled.

Outputs

categorytext
Its category, such as van or truck
contacttext
Its contact
disabledtrue/false
Whether it's disabled
grouptext
The group it's in; empty if none
group_idnumber
The group's ID; 0 if none
idnumber
The device's ID in Traccar
identifiertext
The IMEI, serial number or other ID the device reports
last_updatetext
When Traccar last heard from it (ISO 8601, UTC)
modeltext
Its model
nametext
Its name
phonetext
Its phone number
speed_limit_kmhnumber
Its speed limit in km/h; empty if none is set
statustext
online, offline or unknown (stopped reporting)
status_nametext
Its status as Traccar shows it: Online, Offline or Unknown
Example output
{
  "category": "van",
  "contact": "Sam Driver",
  "disabled": false,
  "group": "Depot vans",
  "group_id": 3,
  "id": 12,
  "identifier": "356307042441013",
  "last_update": "2026-11-06T09:15:02Z",
  "model": "Ford Transit",
  "name": "Van 1",
  "phone": "+15550100",
  "speed_limit_kmh": 80.0,
  "status": "online",
  "status_name": "Online"
}

On this page