Overview
Returns last positions for vehicles in the caller’s company tree, optionally filtered to specific internal vehicle ids (Vehicle.Id, not legacy id).
A V2 version of this endpoint is available: List vehicles. New integrations should prefer V2.
Endpoint
POST /api/devices
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| vehicleIds | integer[] | No | Filter to internal vehicle ids; empty = all allowed vehicles |
Example request body
Response
200 OK — array ofPositionDto (same shape as other position endpoints).
⚠️ Note: The controller declaresDeviceDto[]but the service returnsPositionDtoinstances—trust the runtime JSON (position fields).
Error responses
| Status | Meaning |
|---|---|
| 401 | Token missing, expired, or invalid |
| 403 | Token does not grant access to the requested company |