linxio-js
API Reference

Vehicles and Routes

Vehicle inventory, lifecycle, odometer, engine-hours, counts, types, and route history endpoints.

Vehicle list endpoints support field projection through repeated fields[] query parameters. Route endpoints can produce large responses when coordinates are requested.

GET /vehicles/fields/json

GET

List vehicles

/vehicles/fields/jsonlinxio.vehicles.list(params)

Returns a paginated list of vehicles.

Query parameters

limit
number
optional
Number of records per page.
page
number
optional
Page number to read.
Default: 1
fields[]
string[]
optional
Vehicle fields to include, such as id, regNo, status, lastLoggedAt, or lastCoordinates.
sort
string
optional
Sort expression accepted by Linxio.

Response fields

data
LinxioVehicle[]
optional
Vehicle rows for the current page.
page
number
optional
Current page number.
limit
number
optional
Page size.
total
number
optional
Total matching vehicle count.
aggregations
unknown
optional
Aggregation payload when supplied.

GET /vehicles/{vehicleId}

GET

Get a vehicle

/vehicles/{vehicleId}linxio.vehicles.get(vehicleId)

Returns one vehicle by ID.

Path parameters

vehicleId
LinxioId
required
Vehicle identifier.

Response fields

id
LinxioId
optional
Vehicle identifier.
regNo
string
optional
Registration number when supplied.
defaultLabel
string
optional
Display label when supplied.
lastLoggedAt
ISODateString
optional
Last telemetry timestamp when supplied.

POST /vehicles

POST

Create a vehicle

/vehicleslinxio.vehicles.create(payload)

Creates a vehicle record.

Body parameters

regNo
string
optional
Registration number or fleet identifier.
defaultLabel
string
optional
Default display label.
model
string
optional
Vehicle model.
typeId
LinxioId
optional
Vehicle type identifier.
depotId
LinxioId | null
optional
Depot identifier.
groupIds
LinxioId[]
optional
Vehicle group identifiers.
vin
string
optional
Vehicle identification number.

Response fields

id
LinxioId
optional
Created vehicle ID.
regNo
string
optional
Created vehicle registration number when supplied.

POST /vehicles/{vehicleId}

POST

Update a vehicle

/vehicles/{vehicleId}linxio.vehicles.update(vehicleId, payload)

Updates an existing vehicle.

Path and body parameters

vehicleId
LinxioId
required
Vehicle identifier.
body
LinxioVehiclePayload
required
Fields to update.

Response fields

id
LinxioId
optional
Updated vehicle ID.
regNo
string
optional
Registration number when supplied.

PATCH /vehicles/{vehicleId}/archive

PATCH

Archive a vehicle

/vehicles/{vehicleId}/archivelinxio.vehicles.archive(vehicleId)

Soft-archives a vehicle.

Path parameters

vehicleId
LinxioId
required
Vehicle identifier.

Response

status
204 or JSON
optional
Successful archive response.

POST /vehicles/{vehicleId}/restore

POST

Restore a vehicle

/vehicles/{vehicleId}/restorelinxio.vehicles.restore(vehicleId)

Restores a previously archived vehicle.

Path parameters

vehicleId
LinxioId
required
Archived vehicle identifier.

Response

status
204 or JSON
optional
Successful restore response.

GET /vehicles/{vehicleId}/odometer

GET

Get vehicle odometer

/vehicles/{vehicleId}/odometerlinxio.vehicles.getOdometer(vehicleId, params)

Returns a vehicle odometer reading.

Path and query parameters

vehicleId
LinxioId
required
Vehicle identifier.
occurredAt
ISODateString
optional
Optional occurrence timestamp.

Response fields

odometer
number
optional
Odometer reading.
vehicleId
LinxioId
optional
Vehicle identifier.
occurredAt
ISODateString
optional
Reading timestamp when supplied.

POST /vehicles/{vehicleId}/odometer

POST

Recalibrate vehicle odometer

/vehicles/{vehicleId}/odometerlinxio.vehicles.recalibrateOdometer(vehicleId, payload)

Recalibrates a vehicle odometer.

Path and body parameters

vehicleId
LinxioId
required
Vehicle identifier.
occurredAt
ISODateString
required
When the recalibrated reading applies.
odometer
number
required
New odometer value.

Response fields

odometer
number
optional
Updated odometer value.
vehicleId
LinxioId
optional
Vehicle identifier.

GET /vehicles/{vehicleId}/engine-hours/current

GET

Get vehicle engine hours

/vehicles/{vehicleId}/engine-hours/currentlinxio.vehicles.getEngineHours(vehicleId)

Returns the current engine-hours reading for a vehicle.

Path parameters

vehicleId
LinxioId
required
Vehicle identifier.

Response fields

engineHours
number
optional
Current engine-hours reading.
occurredAt
ISODateString
optional
Reading timestamp when supplied.
vehicleId
LinxioId
optional
Vehicle identifier.

GET /vehicles/count

GET

Count vehicles

/vehicles/countlinxio.vehicles.count(params)

Returns a vehicle count without fetching records.

Query parameters

[filter]
QueryValue
optional
Optional dashboard-derived filters.

Response fields

count
number
optional
Vehicle count when returned by Linxio.
total
number
optional
Vehicle count when returned as total.

GET /vehicles/types

GET

List vehicle types

/vehicles/typeslinxio.vehicles.types(params)

Lists vehicle type categories.

Query parameters

limit
number
optional
Maximum type records.
Default: 1000
sort
string
optional
Sort expression.
Default: order

Response fields

id
LinxioId
optional
Vehicle type identifier.
name
string
optional
Vehicle type display name.
order
number
optional
Sort order when supplied.

GET /vehicles/{vehicleId}/routes

GET

Get vehicle route history

/vehicles/{vehicleId}/routeslinxio.routes.getVehicleRoutes(vehicleId, params)

Returns trip and stop history for one vehicle over a date range.

Path and query parameters

vehicleId
LinxioId
required
Vehicle identifier.
dateFrom
ISODateString
optional
Start date/time.
dateTo
ISODateString
optional
End date/time.
fields[]
string[]
optional
Additional route fields. coordinates can be large.
limit
number
optional
Page size when supported.
page
number
optional
Page number when supported.

Response fields

vehicleId
LinxioId
optional
Vehicle identifier for a route group.
driverId
LinxioId | null
optional
Driver identifier when supplied.
routes
LinxioVehicleRoute[]
optional
Route segments including start/finish points, distance, duration, and optional coordinates.

On this page