Get All Vehicles
Retrieve all vehicle records from FleetIO with automatic pagination handling.
Operation
Section titled “Operation”getVehicles
Resource
Section titled “Resource”vehicle
Parameters
Section titled “Parameters”This operation has no required parameters.
Options
Section titled “Options”| Option | Type | Default | Description |
|---|---|---|---|
| Include Debug Info | boolean | false | Whether to include metadata about the API request |
Response
Section titled “Response”Success
Section titled “Success”Returns an array of vehicle records:
{ "id": 12345, "name": "Truck 001", "vin": "1HGBH41JXMN109186", "license_plate": "ABC-1234", "year": 2022, "make": "Ford", "model": "F-150", "color": "White", "vehicle_type_id": 1, "vehicle_type_name": "Pickup Truck", "vehicle_status_id": 1, "vehicle_status_name": "Active", "current_meter_value": 45230, "current_meter_unit": "mi", "group_id": 5, "group_name": "North Fleet"}With debug info enabled:
{ "id": 12345, "name": "Truck 001", "_metadata": { "totalVehicles": 150, "apiUrl": "https://secure.fleetio.com/api/v1" }}{ "success": false, "error": "FleetIO credential is missing apiKey", "debug": { "apiUrl": "https://secure.fleetio.com/api/v1" }}Response Fields
Section titled “Response Fields”| Field | Type | Description |
|---|---|---|
| id | number | Unique vehicle ID |
| name | string | Vehicle name/identifier |
| vin | string | Vehicle Identification Number |
| license_plate | string | License plate number |
| year | number | Model year |
| make | string | Manufacturer |
| model | string | Vehicle model |
| color | string | Vehicle color |
| vehicle_type_id | number | Vehicle type ID |
| vehicle_type_name | string | Vehicle type name |
| vehicle_status_id | number | Status ID |
| vehicle_status_name | string | Status name |
| current_meter_value | number | Current odometer reading |
| current_meter_unit | string | Odometer unit (mi/km) |
| group_id | number | Fleet group ID |
| group_name | string | Fleet group name |
Error Handling
Section titled “Error Handling”- Missing API URL: FleetIO credential is missing apiUrl
- Missing Account Token: FleetIO credential is missing accountToken
- Missing API Key: FleetIO credential is missing apiKey
- Rate Limiting: API rate limit exceeded
- Authentication Failure: Invalid credentials