Vehicles list

Path: /dashboard/fleet-management/vehicles

Purpose

Maintain a paginated directory of vehicles: search, filter by attributes, open detail, and (with permission) edit or delete.

Prerequisites

• Route: view_vehicle.

Main table

Columns include (among others):

• Plate number (links to vehicle detail).
• Chassis number.
• Vehicle movement status (badge from movementStatus).
• Speed (from telemetry, km/h).
• Fuel / battery (fuel tank sensor telemetries when present).
• Odometer (telemetry).
• Last telemetry update (relative time).
• Actions menu: View details, Edit, Delete (last two depend on permissions).

Data loads with Vehicles.get using pagination and filter parameters.

Search and URL state

• Search uses the search URL parameter (passed as _search to the API).
• Pagination: page, perPage (defaults apply when omitted).

Filters (toolbar)

Open Filter to set:

• Color (color).
• Vehicle type (type).
• Status (status) — object status lookup.
• Inactive since (inactiveSince) — presets such as last 6 hours, 12 hours, 1 day, 3 days, 1 week, 2 weeks, 1 month, more than 1 month.

Apply writes all filter params and resets to page 1. Reset clears filters and resets pagination in the URL.

Add vehicle

The Add vehicle button is visible only with create_vehicle plus form list permissions (see Create and edit vehicles).

Troubleshooting

• Table error state: Use the page’s retry/refetch control; verify network and organization context.
• Missing Edit/Delete: Your role lacks update_vehicle / delete_vehicle or the extra list permissions required for the edit form.
• Unexpected empty filter results: Confirm status and inactive-since combinations; broaden or reset filters.