Leave category list
Leave category list is one of Demiton's published registers for Australian civil construction. Leave types defined in your payroll and operational systems. 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 Workforce in the register catalog.
- Register ID
leave_category_listUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- A stateThe current value of something, replaced when it changes.
- Status
- AvailableFilled today from connected systems, uploads or public data.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1 (1.0.3)Current version.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- Fair Work Act 2009Fair Work Act 2009 - employee records and National Employment Standards
- Fair Work Act 2009Fair Work Regulations 2009 - employee record content
- Payday Super (ATO)Single Touch Payroll reporting under Payday Super
- Single Touch PayrollSingle Touch Payroll Phase 2 employer reporting guidelines
- ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosure
- Employment Leave Act 2026 (NZ)Employment Leave Act 2026 (2026 No 48)
- Holidays Act 2003 (NZ)Holidays Act 2003 (2003 No 129) - holiday and leave record
- SI 1998/1833Working Time Regulations 1998
- Statutory Sick Pay (Social Security Contributions and Benefits Act 1992)Statutory Sick Pay - weekly statutory payment, no day entitlement
Connectors
Connected today
Demiton keeps this register current from these systems now.
- Assignar
- Employment hero
- Employment Hero Payroll
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- MYOB BusinessPartial
- Xero Payroll AU
Fields
32 fields: 6 required, 20 optional, 6 defined by each organisation.
Required
Every record carries these fields.
- codeText
The leave-category code the cross-source alias binding matches on.
Example:
ANN- nameText
Human name of the leave category.
Example:
Annual Leave- unit_typeText
Unit the entitlement and balance are denominated in.
Example:
Hours- source_external_idNumber
The raw record id in the producing system.
Example:
5001- leave_category_typeText
The category's leave type (annual / personal-carer's / long service / …)
Example:
annual- leave_code_entity_idWhole number
Demiton canonical
LEAVE_CODEspine node this fact is about.Example:
301
Optional
Present when the source system records them.
- unitsNumber
The source's unit count/denomination for the category.
Example:
152- is_privateTrue or false
Source privacy flag for the category.
Example:
false- accrual_ruleGroup of fields
The source's accrual-rule object.
- external_codeText
Stable manufacturer/award code where the source supplies one.
- payout_as_etpTrue or false
Whether the category pays out as an employment termination payment.
- is_name_privateTrue or false
Whether the category is hidden from payslips by name.
- leave_unit_typeText
The source's second unit field; its distinction from
unitTypeis unverified.- legal_entity_idWhole number
Owning legal entity where the source is multi-company.
- contingent_periodNumber
The category's contingent period.
- leave_entitlementText
Entitlement value where the source supplies one.
- entitlement_periodNumber
The category's entitlement period.
Example:
12- is_pay_run_accrualTrue or false
Whether accrual happens at pay-run time.
- leave_loading_rateNumber
Leave loading applied to this category.
Example:
17.5- is_balance_untrackedTrue or false
Whether the category is excluded from balance tracking.
- statutory_leave_typeText
The ATO paid-leave type this category maps to (O/P/W/A/C/U)
Example:
O- automatically_accruesTrue or false
Whether the category accrues automatically.
Example:
true- source_classificationText
The source's own classification of the category's origin.
- hide_accruals_on_payslipTrue or false
Whether accruals are hidden on the payslip.
- exclude_from_termination_payoutTrue or false
Whether the category is excluded from a termination payout.
- accrues_first_pay_run_per_period_onlyTrue or false
Accrual timing within a period.
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- deduct_from_primary_pay_categoryTrue or false
Whether the deduction follows the primary pay category.
- use_deduct_from_pay_category_rateTrue or false
Whether the deducting category's rate is used.
- transfer_to_pay_category_referenceNumber
Source id of the tenant-configured pay category this category transfers into.
- default_deduct_from_pay_category_referenceNumber
Source id of the tenant-configured pay category this category deducts from.
- transfer_on_termination_pay_category_referenceNumber
Source id of the tenant-configured pay category used on termination.
- prevent_negative_balance_unpaid_leave_category_referenceText
Source id of the tenant-configured category used to prevent a negative unpaid balance.
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "automatically_accrues": true, "code": "ANN", "entitlement_period": 12, "is_private": false, "leave_category_type": "annual", "leave_code_entity_id": 301, "leave_loading_rate": 17.5, "name": "Annual Leave", "source_external_id": 5001, "source_system": "KEYPAY", "statutory_leave_type": "O", "unit_type": "Hours", "units": 152}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/leave_category_list/v1.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.