Maintenance record
Maintenance record is one of Demiton's published registers for Australian civil construction. Plant service and maintenance records. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.
Part of Assets in the register catalog.
- Register ID
maintenance_recordUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- An eventSomething that happened at a point in time.
- Status
- AvailableFilled today from connected systems, uploads or public data.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v2 (2.1.1)Current version.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- AS 2550Cranes, hoists and winches - Safe use - Mobile elevating work platforms
- AS 2550Cranes, hoists and winches - Mobile elevating work platforms (design and construction)
- GDA2020 / MGA2020Geocentric Datum of Australia 2020 and Map Grid of Australia 2020 (EPSG:7844 / EPSG:78xx zones)
- WHS Act and RegulationsModel Work Health and Safety Act (Safe Work Australia)
- WHS Act and RegulationsModel Work Health and Safety Regulations (Safe Work Australia; given effect by each state/territory)
- ISO 55001Asset management - Asset management system - Requirements
- ISO/TS 15143-3Earth-moving machinery and mobile road construction machinery - Worksite data exchange - Telematics data (AEMP 2.0)
- Health and Safety at Work Act 2015 (NZ)Health and Safety at Work Act 2015
- LOLER 1998Lifting Operations and Lifting Equipment Regulations 1998
- RIDDOR 2013 (SI 2013/1471)Reporting of Injuries, Diseases and Dangerous Occurrences Regulations 2013
- OSHAOSHA - Reporting fatalities, hospitalizations, amputations and losses of an eye
- OSHAOSHA - Overhead and gantry cranes
Connectors
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- EROAD
- GeotabPartial
- HammerTechPartial
- MittiPartial
- Procore
- Sitemate
Fields
24 fields: 3 required, 18 optional, 3 defined by each organisation.
Required
Every record carries these fields.
- assetText
The item of plant the record is about.
Example:
9301- external_idText
The source form-result's own identifier, as text.
Example:
mr-9301-0018- occurred_atDate and time
When the maintenance record was submitted; the date the retention clock runs from.
Example:
2026-08-05T08:00:00Z
Optional
Present when the source system records them.
- workerNumber
The worker who submitted the form; an anchor, not a declared axis.
- form_idNumber
The source form template identity.
- projectNumber
The project the plant was working on when serviced.
- currencycurrency
The currency of
service_cost, an ISO 4217 alpha-3 code as the source states it. A record with no currency has no usable amount.- locationText
The place named on the form where the work happened.
- certifierText
The competent person who performed or certified the service.
- asset_hintText
The free-text machine name the form carries when the top-level asset id is empty, used to resolve the
assetanchor.- asset_typeText
The plant type named on the form (e.g. the machine class)
Example:
Excavator- next_due_atDate
The date the next inspection/service falls due.
- jurisdictionjurisdiction
The WHS/examination regime whose interval and retention rule apply.
- labour_hoursDecimal number
Labour hours booked to the service.
Example:
3- service_costDecimal number
The total cost of the service.
Example:
1240.5- service_dateDate
The date carried on the form, where it differs from submission time.
Example:
2026-08-05- source_unitsGroup of fields
The source unit each measure arrived in, beside the canonical unit.
- machine_hoursDecimal number
Operating-hour meter reading at the time of service — the preferred hour source.
- interval_basisText
Why the next inspection/service is due — statutory interval, a competent person's examination scheme, or the manufacturer's recommendation.
- inspection_classText
Pre-operational / routine / major inspection or service.
- hour_meter_readingDecimal number
The second form family's hour/odometer reading at service.
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- unplannedTrue or false
1 when this maintenance event was a breakdown, 0 when it was planned work.
Example:
false- form_titleText
The tenant's own name for the maintenance form the record was captured on; the key the SAS value-map is bound to.
- tenant_payloadGroup of fields
The tenant's own form questions and answers — servicing notes, faults found, parts, cost components, media/signature answers.
Filed against
Records are indexed along these dimensions, so they can be asked for by any of them.
- Assetwhat the record is about, from
Always set - Projectwhat the record is about, from
When known
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "asset": "9301", "asset_type": "Excavator", "external_id": "mr-9301-0018", "labour_hours": 3, "occurred_at": "2026-08-05T08:00:00Z", "service_cost": 1240.5, "service_date": "2026-08-05", "source_system": "ASSIGNAR", "unplanned": false}Version history
- v2 (current)
- v1
Use this contract
The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.
https://docs.demiton.io/registers/maintenance_record/v2.jsonShow the full JSON Schema
Loading the schema…
Talk to the team
Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would fill from them, on your data, in a 30-minute call.