Get Vehicle Renewals

Retrieve vehicle renewal reminder records from FleetIO, such as registration and inspection renewals.

Operation

getRenewals

Resource

vehicleRenewal

Parameters

This operation has no required parameters.

Options

Option	Type	Default	Description
Include Debug Info	boolean	false	Whether to include metadata about the API request

Response

Success

Returns an array of vehicle renewal records:

{
  "id": 12345,
  "vehicle_id": 789,
  "vehicle_name": "Truck 001",
  "vehicle_renewal_type_id": 1,
  "vehicle_renewal_type_name": "Registration",
  "due_date": "2025-03-15",
  "due_soon_threshold_in_days": 30,
  "overdue": false,
  "due_soon": true,
  "notes": "Annual vehicle registration renewal"
}

Error

{
  "success": false,
  "error": "FleetIO credential is missing apiKey"
}

Response Fields

Field	Type	Description
id	number	Unique renewal ID
vehicle_id	number	Associated vehicle ID
vehicle_name	string	Vehicle name
vehicle_renewal_type_id	number	Renewal type ID
vehicle_renewal_type_name	string	Renewal type name
due_date	string	Due date for renewal
due_soon_threshold_in_days	number	Days before due to trigger alert
overdue	boolean	Whether renewal is overdue
due_soon	boolean	Whether renewal is due soon
notes	string	Additional notes

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