GET
/locations List Locations
Returns a Spring Page envelope (content, page, size, totalElements, totalPages) of LocationDTOs. Narrow the result with a time window (startTime / endTime) and/or by asset (truckIds / driverIds). Each ping includes latitude, longitude, speed, heading (direction + degree), odometer, engine hours, and the embedded truck and driver.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
startTime | query | string | Include pings at or after this instant (ISO 8601 date-time).
e.g. 2026-06-25T00:00:00Z |
endTime | query | string | Include pings at or before this instant (ISO 8601 date-time).
e.g. 2026-06-25T23:59:59Z |
truckIds | query | integer[] | Comma-separated truck ids to filter by (e.g. 1,2,3).
e.g. 1 |
driverIds | query | integer[] | Comma-separated driver ids to filter by (e.g. 1,2,3).
e.g. 1 |
page | query | integer | Zero-based page index (0..N).
e.g. 0 |
size | query | integer | Page size. Default 20.
e.g. 20 |
sort | query | string | Sort as `property,(asc|desc)`. Repeatable.
e.g. deviceDateTime,desc |
The explorer shows the most common query parameters. For the full
operator grammar (
.equals, .contains, .greaterThan, .in, .specified …) see the
Filtering & Sorting
guide.
Response
Status: Stable. Try the request in the panel on the right to see a live response.