Research / Sources / Schemas and history
Schemas and history
Every record here is checked against a JSON Schema, and every schema carries a semantic version: MAJOR when a change can make an existing record invalid, MINOR when it only adds, PATCH for wording. CI refuses a change whose version bump is too small (METHOD.md Section 10). Below is each schema as it stands and every version it has been.
What the codes mean
Every source says where its evidence is from and which part of construction it covers, in two fields on the source schema, jurisdictions and industries. A finding inherits both from its source. The schema types them as lists of codes; the codes each list accepts come from two published standards.
Jurisdictions: ISO 3166
Countries use ISO 3166-1 two-letter codes (AU, NZ). States and regions use ISO 3166-2 codes (AU-QLD): all eight Australian states and territories and all seventeen New Zealand regions are accepted. GLOBAL marks a source that claims no geographic limit, and unknown one where the place could not be determined. When you filter by a state you also get its country's figures and the global ones. The accepted list is vocab/jurisdictions.json. Demiton's obligation library files its obligations under the same codes; the obligation library by place shows how many it holds for each state and region, including the ones where it holds none.
| Code | Place | Sources |
|---|---|---|
NZ | New Zealand | 97 of 217 |
AU | Australia | 72 of 217 |
AU-QLD | Queensland | 16 of 217 |
AU-NSW | New South Wales | 7 of 217 |
GLOBAL | No jurisdictional limit is claimed | 7 of 217 |
AU-VIC | Victoria | 5 of 217 |
US | United States | 3 of 217 |
unknown | Could not be determined | 3 of 217 |
GB | United Kingdom | 2 of 217 |
CX | Christmas Island | 1 of 217 |
CA | Canada | 1 of 217 |
NZ-WGN | Wellington | 1 of 217 |
AU-TAS | Tasmania | 1 of 217 |
NZ-BOP | Bay of Plenty | 1 of 217 |
BE | Belgium | 1 of 217 |
SG | Singapore | 1 of 217 |
AU-WA | Western Australia | 1 of 217 |
Industries: ISIC Rev.4, section F
Industries use the United Nations' International Standard Industrial Classification (ISIC Rev.4), section F (Construction), and its three divisions. ALL marks a source that is not industry-specific, and unknown one where the industry could not be determined. A source can also record the industry in its own words, in the optional industry_as_published, so a mapping to ISIC can be checked against what the source actually said; 11 of 217 do so far. The accepted list is vocab/industries.json.
| Code | Industry | Sources |
|---|---|---|
F | Construction, not further specified (ISIC Rev.4 section F) | 106 of 217 |
F41 | Construction of buildings | 23 of 217 |
F42 | Civil engineering | 62 of 217 |
F43 | Specialised construction activities | 2 of 217 |
ALL | Not industry-specific | 31 of 217 |
unknown | Could not be determined | 1 of 217 |
Filtering by a division, such as civil engineering, also returns figures for construction in general (F) and figures that are not industry-specific.
Source 1.0.0
sources/<slug>.md: where a figure came from, and how it was read · source.schema.json
16 fields at 1.0.0
| Field | Type | Required | Allowed values |
|---|---|---|---|
| title | string | yes | |
| organisation | string | yes | |
| organisation_id | string | ||
| year | integer | yes | |
| published_in | string | ||
| url | string | ||
| free_copy_url | string | ||
| source_type | one of | yes | peer-reviewed, working-paper, regulator, court, industry-body, research-institute, vendor, press |
| method | one of | yes | survey, records, official-statistics, model, case-study, legal-text, estimate, unknown |
| access | one of | yes | primary, secondary |
| read_via | string | ||
| read_on | string | yes | |
| location | string | yes | |
| jurisdictions | list of string | yes | |
| industries | list of string | yes | |
| industry_as_published | string |
Versions
- 1.0.0 2026-09-25no field changes
- unversioned 2026-09-25first published, 16 fields
Finding 3.0.0
diseases/<disease>/<metric>.yaml and context/<metric>.yaml: one figure · finding.schema.json
41 fields at 3.0.0
| Field | Type | Required | Allowed values |
|---|---|---|---|
| label | string | yes | |
| exposure_value | number or null | yes | |
| exposure_unit | one of | yes | ratio_of_contract, ratio_of_other, per_wet_day, per_incident, none |
| denominator | one of | budget_at_decision, budget_at_announcement, construction_cost, amount_claimed, arbitration_cost, total_injury_cost, overrun_additional_cost, annual_capital_budget | |
| currency | string | ||
| price_year | integer | ||
| exposure_basis | string | yes | |
| exposure_kind | one of | yes | contractor_loss, derived_contractor_loss, money_at_stake, owner_side, societal, context |
| confidence | one of | yes | high, moderate, low |
| exposure_range | object | ||
| exposure_range.low | number | yes | |
| exposure_range.high | number | yes | |
| exposure_range.kind | one of | yes | confidence_interval, reported_min_max, scenario, across_studies |
| derivation | one of | yes | as_published, calculated |
| calculation | string | ||
| sources | list of | yes | |
| considered | list of records | ||
| considered[].source | yes | ||
| considered[].reason | string | yes | |
| sample_note | string | yes | |
| caveat | string | yes | |
| status | one of | yes | current, disputed, withdrawn |
| dispute_url | string | ||
| withdrawn_reason | string | ||
| history | list of records | ||
| history[].exposure_value | number or null | ||
| history[].exposure_unit | string | ||
| history[].denominator | string | ||
| history[].exposure_range | object | ||
| history[].exposure_kind | string | ||
| history[].confidence | string | ||
| history[].is_headline | boolean | ||
| history[].changed_on | string | yes | |
| history[].change_url | string | ||
| history[].reason | string | yes | |
| subtype | string | ||
| statistic | one of | mean, median, pooled_ratio, total, single_case, modelled, none, unknown | |
| sample_size | object | ||
| sample_size.n | integer | yes | |
| sample_size.unit | one of | yes | projects, respondents, organisations, decisions, awards, contracts, cases, years, other |
| sample_size.note | string |
Versions
- 3.0.0 not yet merged~1 changedpinned from demitonapp/registers
What changed from the version before
subtype changed description changed - 2.3.0 2026-09-26+5 added
What changed from the version before
statistic added optional sample_size added optional sample_size.n added required sample_size.unit added required sample_size.note added optional - 2.2.0 2026-09-26~1 changed
What changed from the version before
exposure_kind changed allows derived_contractor_loss - 2.1.0 2026-09-26+1 added
What changed from the version before
subtype added optional - 2.0.0 2026-09-25-1 removed
What changed from the version before
is_headline removed - 1.2.0 2026-09-25no field changes
- unversioned 2026-09-25~1 changed
What changed from the version before
denominator changed allows annual_capital_budget - unversioned 2026-09-25~1 changed
What changed from the version before
denominator changed allows overrun_additional_cost - unversioned 2026-09-25first published, 36 fields
Protection 1.0.0
protections/<disease>/<mechanism>.yaml: evidence that a protection matters · protection.schema.json
9 fields at 1.0.0
| Field | Type | Required | Allowed values |
|---|---|---|---|
| label | string | yes | |
| claim | string | yes | |
| sources | finding: sources | yes | |
| considered | finding: considered | ||
| confidence | one of | yes | high, moderate, low |
| caveat | string | yes | |
| status | one of | yes | current, disputed, withdrawn |
| dispute_url | string | ||
| withdrawn_reason | string |
Versions
- 1.0.0 2026-09-25no field changes
- unversioned 2026-09-25first published, 9 fields