Guides
Changelog
Back to All
Added

Maintenance Record Endpoints in the Public API

over 1 year ago

Release Date: April 18, 2025

What's New?

Asset maintenance records are now readable through the Public API, enabling fleet maintenance platforms (e.g. FleetRock) and reporting tools to sync maintenance history for trucks and trailers.

What Changed?

Previously, maintenance records were only visible inside the Alvys platform.

Now, the Public API includes:

GET  /api/p/v{version}/maintenance/{id}
POST /api/p/v{version}/maintenance/search
  • Get maintenance record — retrieve a single record by id.
  • Search maintenance records — search and paginate records.

Response Body Includes

  • Core: Id, PO, Reference, Description, Comments
  • Classification: Category
  • Asset: RelatedAsset (the truck or trailer the record belongs to)
  • Financial: Amount (value + currency)
  • Shop: RepairShop details
  • Scheduling: Reminders
  • Audit: CreatedAt, CreatedBy, ModifiedAt, ModifiedBy

Why?

Maintenance spend and history live at the intersection of operations and accounting. Exposing these records lets maintenance vendors and analytics tools stay in sync with Alvys without manual exports.