# Traccar

> 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.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/traccar

## Actions

### Assign geofence

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

**Inputs**

- Geofence (`geofence`, text, required): The geofence: pick it, or give its name or ID.
- Devices (`devices`, list): The devices to watch it for.
- Group (`group`, text): Watch it for every device in this group.

**Outputs**

- `count` (number): How many devices and groups it was assigned to
- `devices` (list): The devices it was assigned to
- `geofence` (text): Its name
- `geofence_id` (number): The geofence's ID
- `group` (text): The group it was assigned to; empty if none

**Example output**

```json
{
  "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 (`name`, text, required): What to call it, such as the vehicle's registration.
- Identifier (`identifier`, text, required): The IMEI, serial number or other ID the device reports. It must match what the device sends.
- Group (`group`, text): The group to put it in.
- Category (`category`, text): 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 (`phone`, text): The SIM card's phone number.
- Model (`model`, text): The vehicle or tracker model.
- Contact (`contact`, text): Who to contact about it.
- Speed limit (km/h) (`speed_limit_kmh`, number): Over this, Traccar records Speed limit exceeded. From 0 to 1000.

**Outputs**

- `category` (text): Its category, such as van or truck
- `contact` (text): Its contact
- `disabled` (true/false): Whether it's disabled
- `group` (text): The group it's in; empty if none
- `group_id` (number): The group's ID; 0 if none
- `id` (number): The device's ID in Traccar
- `identifier` (text): The IMEI, serial number or other ID the device reports
- `last_update` (text): When Traccar last heard from it (ISO 8601, UTC)
- `model` (text): Its model
- `name` (text): Its name
- `phone` (text): Its phone number
- `speed_limit_kmh` (number): Its speed limit in km/h; empty if none is set
- `status` (text): online, offline or unknown (stopped reporting)
- `status_name` (text): Its status as Traccar shows it: Online, Offline or Unknown

**Example output**

```json
{
  "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 (`name`, text, required): What to call the place.
- Latitude (`latitude`, number): A circle's centre: latitude, such as 51.5007. From -90 to 90.
- Longitude (`longitude`, number): A circle's centre: longitude, such as -0.1246. From -180 to 180.
- Radius (metres) (`radius_m`, number): A circle's radius. Defaults to 200 metres. From 1 to 500000.
- Area (`area`, text): 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 (`description`, text): What it's for.
- Assign to devices (`devices`, list): Watch it for these devices.
- Assign to group (`group`, text): Watch it for every device in this group.

**Outputs**

- `area` (text): The shape as Traccar stores it (WKT, latitude first)
- `assigned_devices` (list): The devices it was assigned to
- `assigned_group` (text): The group it was assigned to; empty if none
- `description` (text): Its description
- `id` (number): The geofence's ID
- `latitude` (number): A circle's centre: latitude; empty for other shapes
- `longitude` (number): A circle's centre: longitude
- `map_link` (text): A link that opens a circle's centre on a map
- `name` (text): Its name
- `radius_m` (number): A circle's radius in metres
- `shape` (text): circle, polygon or line

**Example output**

```json
{
  "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 (`device`, text, required): The device: pick it, or give its name, identifier (IMEI) or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The deleted device's ID
- `identifier` (text): Its identifier
- `name` (text): Its name

**Example output**

```json
{
  "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 (`geofence`, text, required): The geofence: pick it, or give its name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The deleted geofence's ID
- `name` (text): Its name

**Example output**

```json
{
  "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_types`, list): 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 (`devices`, list): Only these devices. Leave blank for every device (or the group's).
- Group (`group`, text): Only the devices in this group, and in the groups inside it.
- Geofence (`geofence`, text): Only events at this geofence.
- Period (`period`, text): 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 (`start`, date and time): Start here instead of at the period's start.
- To (`end`, date and time): End here. Leave blank for now.
- Time zone (`time_zone`, text): 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 (`limit`, number): The most events to list, the latest kept. Defaults to 200. From 1 to 2000.

**Outputs**

- `count` (number): How many are listed
- `events` (list): The events, oldest first
- `from` (text): When the report starts (ISO 8601, UTC)
- `group` (text): The group searched; empty if none was picked
- `has_more` (true/false): Whether there were more than the step lists (the latest are kept)
- `time_zone` (text): The time zone the period was read in, such as Europe/London
- `to` (text): When the report ends (ISO 8601, UTC)
- `total_count` (number): How many happened in that time

**Example output**

```json
{
  "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 (`device`, text, required): The device: pick it, or give its name, identifier (IMEI) or ID.
- Period (`period`, text): 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 (`start`, date and time): Start here instead of at the period's start.
- To (`end`, date and time): End here. Leave blank for now.
- Time zone (`time_zone`, text): 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 (`limit`, number): The most positions to list, the earliest first. Defaults to 500. From 1 to 5000.

**Outputs**

- `count` (number): How many are listed
- `device` (text): The device's name
- `device_id` (number): The device's ID
- `distance_km` (number): Distance covered in that time, in km
- `distance_mi` (number): Distance covered, in miles
- `from` (text): When the report starts (ISO 8601, UTC)
- `has_more` (true/false): Whether there were more than the step lists
- `max_speed_kmh` (number): Its top speed in that time, in km/h
- `positions` (list): Its positions, oldest first
- `time_zone` (text): The time zone the period was read in, such as Europe/London
- `to` (text): When the report ends (ISO 8601, UTC)
- `total_count` (number): How many it reported in that time

**Example output**

```json
{
  "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 (`device`, text, required): The device: pick it, or give its name, identifier (IMEI) or ID.

**Outputs**

- `address` (text): The address, if the server looks addresses up
- `altitude` (number): Altitude in metres
- `battery_level` (number): Battery level in percent, if reported
- `course` (number): Heading in degrees, 0 being north
- `device` (text): The device's name
- `device_id` (number): The device's ID
- `fix_time` (text): When the position was taken (ISO 8601, UTC)
- `geofences` (list): The geofences it was inside
- `has_location` (true/false): Whether it has reported a position yet
- `identifier` (text): The device's identifier
- `ignition` (text): on or off; empty if the device doesn't report it
- `last_update` (text): When Traccar last heard from it (ISO 8601, UTC)
- `latitude` (number): Latitude
- `longitude` (number): Longitude
- `map_link` (text): A link that opens the place on a map
- `moving` (true/false): Whether it was moving
- `odometer_km` (number): The vehicle's odometer in km, if reported
- `position_id` (number): The position's ID
- `server_time` (text): When Traccar received it (ISO 8601, UTC)
- `speed_kmh` (number): Speed in km/h
- `speed_mph` (number): Speed in mph
- `status` (text): online, offline or unknown
- `status_name` (text): Online, Offline or Unknown
- `total_distance_km` (number): Distance travelled as Traccar counts it, in km
- `valid` (true/false): Whether the device had a GPS fix

**Example output**

```json
{
  "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 (`devices`, list): Only these devices. Leave blank for every device (or the group's).
- Group (`group`, text): Only the devices in this group, and in the groups inside it.
- Period (`period`, text): 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 (`start`, date and time): Start here instead of at the period's start.
- To (`end`, date and time): End here. Leave blank for now.
- Time zone (`time_zone`, text): 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**

- `count` (number): How many stops
- `from` (text): When the report starts (ISO 8601, UTC)
- `group` (text): The group reported on; empty if none was picked
- `stops` (list): Each stop, earliest first
- `time_zone` (text): The time zone the period was read in, such as Europe/London
- `to` (text): When the report ends (ISO 8601, UTC)

**Example output**

```json
{
  "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 (`devices`, list): Only these devices. Leave blank for every device (or the group's).
- Group (`group`, text): Only the devices in this group, and in the groups inside it.
- Period (`period`, text): 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 (`start`, date and time): Start here instead of at the period's start.
- To (`end`, date and time): End here. Leave blank for now.
- Time zone (`time_zone`, text): 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**

- `count` (number): How many devices
- `devices` (list): Each device's totals, by name
- `from` (text): When the report starts (ISO 8601, UTC)
- `group` (text): The group reported on; empty if none was picked
- `time_zone` (text): The time zone the period was read in, such as Europe/London
- `to` (text): When the report ends (ISO 8601, UTC)
- `total_distance_km` (number): All their distance together, in km
- `total_distance_mi` (number): All their distance together, in miles
- `total_engine_hours` (number): All their engine hours together

**Example output**

```json
{
  "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 (`devices`, list): Only these devices. Leave blank for every device (or the group's).
- Group (`group`, text): Only the devices in this group, and in the groups inside it.
- Period (`period`, text): 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 (`start`, date and time): Start here instead of at the period's start.
- To (`end`, date and time): End here. Leave blank for now.
- Time zone (`time_zone`, text): 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**

- `count` (number): How many trips
- `from` (text): When the report starts (ISO 8601, UTC)
- `group` (text): The group reported on; empty if none was picked
- `time_zone` (text): The time zone the period was read in, such as Europe/London
- `to` (text): When the report ends (ISO 8601, UTC)
- `total_distance_km` (number): Their distance together, in km
- `total_distance_mi` (number): Their distance together, in miles
- `total_duration_minutes` (number): Their driving time together, in minutes
- `trips` (list): Each trip, earliest first

**Example output**

```json
{
  "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 (`status`, text): Only devices with this status. One of: `any`, `online`, `not_online` (Offline or unknown), `offline`, `unknown` (Unknown (stopped reporting)). Default: `any`.
- Group (`group`, text): Only the devices in this group, and in the groups inside it.
- Name or identifier (`search`, text): Only devices whose name or identifier contains this.

**Outputs**

- `count` (number): How many are listed
- `devices` (list): The devices, by name
- `offline_count` (number): How many are offline
- `online_count` (number): How many of the user's devices (in the group, if one was picked) are online
- `unknown_count` (number): How many have stopped reporting (status unknown)

**Example output**

```json
{
  "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 (`device`, text): Only geofences assigned to this device itself (not through its group).

**Outputs**

- `count` (number): How many
- `geofences` (list): The geofences, by name

**Example output**

```json
{
  "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 (`device`, text, required): The device: pick it, or give its name, identifier (IMEI) or ID.
- Command (`command`, text, required): 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 (`text`, text): For Custom Command, the exact text the device takes; for Message, the message to show.

**Outputs**

- `command` (text): The command's type, such as engineStop or custom
- `command_name` (text): The command as Traccar shows it, such as Engine Stop
- `device` (text): The device's name
- `device_id` (number): The device's ID
- `id` (number): The command's ID in Traccar's queue; 0 when it went out at once
- `queued` (true/false): Whether it's waiting for the device to connect
- `status` (text): sent, or queued until the device next connects

**Example output**

```json
{
  "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 (`device`, text, required): The device: pick it, or give its name, identifier (IMEI) or ID.
- Name (`name`, text): A new name. Leave blank to keep it.
- Identifier (`identifier`, text): The IMEI, serial number or other ID the device reports. It must match what the device sends. Leave blank to keep it.
- Group (`group`, text): The group to put it in. Leave blank to keep it.
- Category (`category`, text): 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 (`phone`, text): The SIM card's phone number. Leave blank to keep it.
- Model (`model`, text): The vehicle or tracker model. Leave blank to keep it.
- Contact (`contact`, text): Who to contact about it. Leave blank to keep it.
- Speed limit (km/h) (`speed_limit_kmh`, number): Over this, Traccar records Speed limit exceeded. 0 removes it. Leave blank to keep it. From 0 to 1000.
- Disabled (`disabled`, text): Disable it (Traccar ignores what it sends) or enable it. Leave blank to keep it. One of: `disabled`, `enabled`.

**Outputs**

- `category` (text): Its category, such as van or truck
- `contact` (text): Its contact
- `disabled` (true/false): Whether it's disabled
- `group` (text): The group it's in; empty if none
- `group_id` (number): The group's ID; 0 if none
- `id` (number): The device's ID in Traccar
- `identifier` (text): The IMEI, serial number or other ID the device reports
- `last_update` (text): When Traccar last heard from it (ISO 8601, UTC)
- `model` (text): Its model
- `name` (text): Its name
- `phone` (text): Its phone number
- `speed_limit_kmh` (number): Its speed limit in km/h; empty if none is set
- `status` (text): online, offline or unknown (stopped reporting)
- `status_name` (text): Its status as Traccar shows it: Online, Offline or Unknown

**Example output**

```json
{
  "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"
}
```
