Retention position

Retention position is one of Demiton's published registers for Australian civil construction. Retention currently withheld on a job, and its status. 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 Contracts in the register catalog.

Register ID

retention_positionUse 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

v2 (2.0.2)Current version.

Download JSON SchemaSee an example record

Standards

This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.

• AS 4000General Conditions of Contract (superseded edition, still in use)Australia · 1997 · paywalled, from a secondary description
• AS 4000General Conditions of Contract (construct only)Australia · 2025 · clause Annexure Part A (per commentary) · paywalled, from a secondary description
• AS 4902General Conditions of Contract for Design and ConstructAustralia · 2000 · paywalled, from a secondary description
• Corporations Act 2001 (Cth) s 286Corporations Act 2001 (Cth) - financial records, 7-year retentionAustralia · current · clause s 286 · verified against full text
• Security of paymentBuilding Industry Fairness (Security of Payment) Act 2017 (Qld)Australia · 2017 as amended · public summary
• Security of paymentBuilding and Construction Industry Security of Payment Act 2002 (Vic), as amended from 15 Apr 2026Australia · 2002 as amended 15 Apr 2026 · clause ss 17A-17H (per commentary) · public summary
• Security of paymentBuilding and Construction Industry (Security of Payment) Act 2021 (WA)Australia · 2021 · clause ss 59, 71-77 · verified against full text
• NZ CCA 2002Construction Contracts Act 2002 (NZ), 2002 No 46, as amended 2015 and 2023New Zealand · as at 5 Oct 2023 · clause ss 18B, 18C, 18D, 18DA, 18FD · verified against full text
• HGCRA 1996 Part IIHousing Grants, Construction and Regeneration Act 1996, Part II (as amended by LDEDCA 2009)United Kingdom · 1996 c. 53 as amended · clause ss 111, 113 · verified against full text
• AIA G702/G703Application and Certificate for Payment; Continuation SheetUnited States · 1992 (current base editions) · public summary

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Business Central
• Xero

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 AcumaticaPartial
• Oracle Aconex
• Payapps
• Procore

Fields

8 fields: 2 required, 5 optional, 1 defined by each organisation.

Required

Every record carries these fields.

project_refText

The subject project's stable external reference (today the ERP job number).

Example: BWG-2025-002

retention_heldTrue or false

Whether money is currently withheld by the client.

Example: true

Optional

Present when the source system records them.

contract_refText

The contract or trust account the retention attaches to.

Example: TEN/2963

retention_basisText

How the retention was calculated (percent of each claim, accumulated, cap)

Example: 5% of certified value to practical completion

retention_amountDecimal numberUnit: currency of the bound legal entity

The amount currently withheld, as recorded by the source.

Example: 97500

retention_currencycurrency

The currency the amount is denominated in.

Example: AUD

retention_amount_sourceText

Which system actually supplied retention_amount (today the constant bc_job_card_unpopulated)

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

retention_statusText

The producer's lifecycle code: PC, DLP, BG, COMPLETED

Example: held

Filed against

Records are indexed along these dimensions, so they can be asked for by any of them.

• Customercontext for the record, from When known
• Legal entitycontext for the record, 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.

retention_position.example.json

{
  "contract_ref": "TEN/2963",
  "project_ref": "BWG-2025-002",
  "retention_amount": 97500,
  "retention_basis": "5% of certified value to practical completion",
  "retention_currency": "AUD",
  "retention_held": true,
  "retention_status": "held"
}

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.

Schema URL

https://docs.demiton.io/registers/retention_position/v2.json

Show the full JSON Schema

Loading the schema…