Get Devices

Fetch the list of devices from your Traccar server.

WARNING

• Standard users can only use this operation with their own userId. Admins or managers may request devices for any user.
• Without any params, returns a list of the user's devices

Request

Use the ThingsTelemetry\Traccar\Facades\Device::all() method to retrieve devices.

use ThingsTelemetry\Traccar\Facades\Device;

// Returns a list of the user's devices
$devices = Device::all(); // Illuminate\Support\Collection of DeviceData

Usage

1) For a given user

use ThingsTelemetry\Traccar\Facades\Device;

$userId = 123;
$devices = Device::all(userId: $userId); // Illuminate\Support\Collection of DeviceData

2) By device IDs

use ThingsTelemetry\Traccar\Facades\Device;

$devices = Device::all(ids: [6, 7]); // Illuminate\Support\Collection of DeviceData

3) By uniqueIds

use ThingsTelemetry\Traccar\Facades\Device;

$devices = Device::all(uniqueIds: ['ABC123', 'XYZ789']); // Illuminate\Support\Collection of DeviceData

4) Combined filters (userId + ids + uniqueIds)

use ThingsTelemetry\Traccar\Facades\Device;

$devices = Device::all(userId: 123, ids: [6], uniqueIds: ['ABC123']); // Illuminate\Support\Collection of DeviceData

5) Pagination and Search

use ThingsTelemetry\Traccar\Facades\Device;

$devices = Device::all(
    limit: 10,
    offset: 0,
    keyword: 'truck'
);

6) Advanced Flags

use ThingsTelemetry\Traccar\Facades\Device;

$devices = Device::all(
    all: true, // Fetch all devices (Admin only)
    excludeAttributes: true // Exclude attributes from the response
);

Results

The response is a Illuminate\Support\Collection<int, ThingsTelemetry\Traccar\Dto\DeviceData>.

$first = $devices->first();

$name = $first->name;                 // "Truck 1"
$status = $first->status->label();    // "Online"
$category = $first->category->value;  // "truck"
$lastSeen = $first->lastUpdate?->toIso8601String();

// Attributes (typed)
$speedLimit = $first->attributes->speedLimit; // 80.0 (knots)

Key Result Items

• status → DeviceStatus Enum representing device connection state.
• category → DeviceCategory Enum representing device category/type.
• attributes → DeviceAttributesData Typed DTO for device attributes.

Important Links

• Traccar Fetch a list of Devices
• DeviceData DTO reference
• DeviceAttributesData DTO reference