Legal entities (v1)
Legal entities is one of Demiton's published registers for Australian civil construction. The operating companies in your group: the root every worker, project and cost code belongs to. 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 Counterparties in the register catalog.
- Register ID
legal_entitiesUse 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.1)Superseded by v2.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- A New Tax System (Australian Business Number) Act 1999ABN and the Australian Business Register (ABN Lookup)
- A New Tax System (Goods and Services Tax) Act 1999 - tax invoice requirementsGST tax invoice particulars (ATO tax invoice guidance)
- Privacy Act 1988Privacy Act 1988 - Australian Privacy Principles
- Single Touch PayrollATO Single Touch Payroll reporting (employer ABN/branch)
- Commission Implementing Regulation (EU) 2019/1780 (eForms), as amended by (EU) 2023/2884eForms standard forms for public procurement notices
- GDPRGeneral Data Protection Regulation
- Goods and Services Tax Act 1985 (NZ) - taxable supply informationGST taxable supply information (Inland Revenue guidance, in force 2023-04-01)
- New Zealand Business Number Act 2016NZBN Act 2016 and the NZBN Register
- Privacy Act 2020 (NZ)Privacy Act 2020 - Information Privacy Principles
- HMRC Real Time Information (RTI)PAYE Real Time Information employer references (employer PAYE reference, Accounts Office reference)
- Procurement Regulations 2024 (SI 2024/692)Procurement Regulations 2024, contract award notice content (under Procurement Act 2023)
- UK GDPRUK General Data Protection Regulation with Data Protection Act 2018
- FAR 52.204-7Federal Acquisition Regulation clause 52.204-7 System for Award Management (SAM unique entity identifier) (Unique Entity ID, UEI)
Connectors
Connected today
Demiton keeps this register current from these systems now.
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- HammerTechPartial
- MYOB Acumatica
- MYOB Business
- Oracle AconexPartial
- PayappsPartial
- Xero Accounting
Fields
20 fields: 4 required, 13 optional, 3 defined by each organisation.
Required
Every record carries these fields.
- legal_nameText
Registered/legal name of the entity.
Example:
Bridgeworks Group Pty Ltd- external_idText
The source system's own company id.
Example:
BWG-AU- base_currencyText
The entity's functional currency.
Example:
AUD- source_systemText
The system the entity record was read from.
Example:
D365_BUSINESS_CENTRAL
Optional
Present when the source system records them.
- localityText
Suburb/city.
Example:
Kawana- postal_codeText
Postal code.
Example:
4701- country_codeText
Country of registration/operation.
Example:
AU- trading_nameText
Name the entity trades under, if different.
Example:
Bridgeworks Group- address_line1Text
Street address line 1.
Example:
42 Depot Road- address_line2Text
Street address line 2.
- primary_emailText
The entity's general contact email.
Example:
accounts@example.com- primary_phoneText
The entity's general contact phone.
Example:
0400 000 001- fiscal_year_startNumber
Financial-year start.
- administrative_areaText
State/region.
Example:
QLD- registration_statusText
Registration state at a point in time.
Example:
active- primary_contact_nameText
The entity's general contact person.
Example:
Brett Hollis- registration_status_as_atDate
When that status was verified.
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- identifier_valueText
The identifier in that scheme.
Example:
83167229410- identifier_schemeText
The scheme the primary identifier belongs to.
Example:
ABN- identifier_authorityText
The register/authority that issues or validates the identifier.
Example:
Australian Business Register
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "address_line1": "42 Depot Road", "administrative_area": "QLD", "base_currency": "AUD", "country_code": "AU", "external_id": "BWG-AU", "identifier_authority": "Australian Business Register", "identifier_scheme": "ABN", "identifier_value": "83167229410", "legal_name": "Bridgeworks Group Pty Ltd", "locality": "Kawana", "postal_code": "4701", "primary_contact_name": "Brett Hollis", "primary_email": "accounts@example.com", "primary_phone": "0400 000 001", "registration_status": "active", "source_system": "D365_BUSINESS_CENTRAL", "trading_name": "Bridgeworks Group"}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/legal_entities/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.