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
| Action | What it does |
|---|---|
| Assign geofence | Have Traccar watch a geofence for some devices or a group, so entering and leaving it are recorded as events. |
| 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. |
| Create geofence | Draw a geofence, such as a new job site: a circle round a point, or an area. |
| Delete device | Delete a device, such as a sold vehicle's tracker, with its history of positions and events. |
| Delete geofence | Delete a geofence, such as a finished job site's. Past events there are kept. |
| 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. |
| Find positions | Get where a device was over a period, oldest first, with the distance it covered and its top speed: its route. |
| 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. |
| Get stops | Get each place a device stood still and for how long, such as yesterday's. |
| 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. |
| 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. |
| List devices | List your vehicles and other tracked devices with their status (online, offline, unknown), when each last reported and where it is now. |
| List geofences | List the geofences the connected user can see, or those assigned to one device, with their shapes. |
| Send command | Send a device a command its model supports, such as Single Reporting or Engine Stop. |
| Update device | Change 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
- Geofence
geofencetextRequired - The geofence: pick it, or give its name or ID.
- Devices
deviceslist - The devices to watch it for.
- Group
grouptext - 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
- Name
nametextRequired - What to call it, such as the vehicle's registration.
- Identifier
identifiertextRequired - The IMEI, serial number or other ID the device reports. It must match what the device sends.
- Group
grouptext - The group to put it in.
- Category
categorytext - 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. - Phone
phonetext - The SIM card's phone number.
- Model
modeltext - The vehicle or tracker model.
- Contact
contacttext - 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
- Name
nametextRequired - What to call the place.
- Latitude
latitudenumber - A circle's centre: latitude, such as 51.5007.From -90 to 90.
- Longitude
longitudenumber - 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.
- Area
areatext - 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)).
- Description
descriptiontext - What it's for.
- Assign to devices
deviceslist - Watch it for these devices.
- Assign to group
grouptext - 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
- Device
devicetextRequired - 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
- Geofence
geofencetextRequired - 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 types
event_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. - Devices
deviceslist - Only these devices. Leave blank for every device (or the group's).
- Group
grouptext - Only the devices in this group, and in the groups inside it.
- Geofence
geofencetext - Only events at this geofence.
- Period
periodtext - 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. - From
startdate and time - Start here instead of at the period's start.
- To
enddate and time - End here. Leave blank for now.
- Time zone
time_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 many
limitnumber - 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
- Device
devicetextRequired - The device: pick it, or give its name, identifier (IMEI) or ID.
- Period
periodtext - 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. - From
startdate and time - Start here instead of at the period's start.
- To
enddate and time - End here. Leave blank for now.
- Time zone
time_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 many
limitnumber - 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
- Device
devicetextRequired - 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
- Devices
deviceslist - Only these devices. Leave blank for every device (or the group's).
- Group
grouptext - Only the devices in this group, and in the groups inside it.
- Period
periodtext - 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. - From
startdate and time - Start here instead of at the period's start.
- To
enddate and time - End here. Leave blank for now.
- Time zone
time_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
- Devices
deviceslist - Only these devices. Leave blank for every device (or the group's).
- Group
grouptext - Only the devices in this group, and in the groups inside it.
- Period
periodtext - 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. - From
startdate and time - Start here instead of at the period's start.
- To
enddate and time - End here. Leave blank for now.
- Time zone
time_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
- Devices
deviceslist - Only these devices. Leave blank for every device (or the group's).
- Group
grouptext - Only the devices in this group, and in the groups inside it.
- Period
periodtext - 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. - From
startdate and time - Start here instead of at the period's start.
- To
enddate and time - End here. Leave blank for now.
- Time zone
time_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
- Status
statustext - Only devices with this status.One of:
any,online,not_online(Offline or unknown),offline,unknown(Unknown (stopped reporting)). Default:any. - Group
grouptext - Only the devices in this group, and in the groups inside it.
- Name or identifier
searchtext - 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
- Device
devicetext - 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
- Device
devicetextRequired - The device: pick it, or give its name, identifier (IMEI) or ID.
- Command
commandtextRequired - 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). - Text
texttext - 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
- Device
devicetextRequired - The device: pick it, or give its name, identifier (IMEI) or ID.
- Name
nametext - A new name. Leave blank to keep it.
- Identifier
identifiertext - The IMEI, serial number or other ID the device reports. It must match what the device sends. Leave blank to keep it.
- Group
grouptext - The group to put it in. Leave blank to keep it.
- Category
categorytext - 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. - Phone
phonetext - The SIM card's phone number. Leave blank to keep it.
- Model
modeltext - The vehicle or tracker model. Leave blank to keep it.
- Contact
contacttext - 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.
- Disabled
disabledtext - 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"
}