Demiton · Schema

utility_location contract v1

Subsurface utilities on a site, with their AS 5488 quality level.

CompanyConstructionCivil EngineeringProject ManagementComplianceMCPArtificial IntelligenceOpen Contracting

Properties

Name	Type	Description
depth_m	number	the depth of the utility below surface
project	string	the project the utility was located on
geometry	object	the located point or line
validated	boolean	whether the position is validated
asset_owner	string	the utility owner or network operator
external_id	string	the source's own feature id
utility_type	string	the service, e.g. water, gas, electrical or telecommunications
quality_level	string	the quality level of the location information, QL-D to QL-A
vertical_datum	string	the datum any depth or level is referenced to, e.g. AHD
detection_method	string	how the position was obtained, e.g. records, electromagnetic locator, ground-penetrating radar or trial pit
horizontal_datum	string	the datum and projection of the geometry, e.g. MGA2020 zone 56
report_reference	string	the survey report the location comes from
vertical_accuracy_m	number	the vertical accuracy of the position
quality_level_scheme	string	the scheme and edition the level is from, e.g. AS 5488.1:2022
horizontal_accuracy_m	number	the horizontal accuracy of the position

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/utility_location/v1.json",
  "title": "utility_location contract v1",
  "type": "object",
  "required": [
    "project",
    "quality_level",
    "quality_level_scheme",
    "utility_type"
  ],
  "properties": {
    "depth_m": {
      "type": "number",
      "description": "the depth of the utility below surface",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "project": {
      "type": "string",
      "description": "the project the utility was located on",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "geometry": {
      "type": "object",
      "description": "the located point or line",
      "x-demiton-requiredness": "optional"
    },
    "validated": {
      "type": "boolean",
      "description": "whether the position is validated",
      "x-demiton-requiredness": "optional"
    },
    "asset_owner": {
      "type": "string",
      "description": "the utility owner or network operator",
      "x-demiton-requiredness": "optional"
    },
    "external_id": {
      "type": "string",
      "description": "the source's own feature id",
      "x-demiton-requiredness": "optional"
    },
    "utility_type": {
      "type": "string",
      "description": "the service, e.g. water, gas, electrical or telecommunications",
      "x-demiton-requiredness": "required"
    },
    "quality_level": {
      "type": "string",
      "description": "the quality level of the location information, QL-D to QL-A",
      "x-demiton-requiredness": "required"
    },
    "vertical_datum": {
      "type": "string",
      "description": "the datum any depth or level is referenced to, e.g. AHD",
      "x-demiton-requiredness": "optional"
    },
    "detection_method": {
      "type": "string",
      "description": "how the position was obtained, e.g. records, electromagnetic locator, ground-penetrating radar or trial pit",
      "x-demiton-requiredness": "optional"
    },
    "horizontal_datum": {
      "type": "string",
      "description": "the datum and projection of the geometry, e.g. MGA2020 zone 56",
      "x-demiton-requiredness": "optional"
    },
    "report_reference": {
      "type": "string",
      "description": "the survey report the location comes from",
      "x-demiton-requiredness": "optional"
    },
    "vertical_accuracy_m": {
      "type": "number",
      "description": "the vertical accuracy of the position",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "quality_level_scheme": {
      "type": "string",
      "description": "the scheme and edition the level is from, e.g. AS 5488.1:2022",
      "x-demiton-requiredness": "required"
    },
    "horizontal_accuracy_m": {
      "type": "number",
      "description": "the horizontal accuracy of the position",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "utility_location",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AHD / AUSGeoid2020",
        "title": "Australian Height Datum with AUSGeoid2020 separation model",
        "access": "full_text_verified",
        "region": "Australia",
        "edition": "AHD71; AUSGeoid2020",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 5488.1:2022",
        "title": "Classification of Subsurface Utility Information (SUI)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2022 (2nd ed.)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "GDA2020 / MGA2020",
        "title": "Geocentric Datum of Australia 2020 and Map Grid of Australia 2020",
        "access": "full_text_verified",
        "region": "Australia",
        "edition": "GDA2020 (ITRF2014 @ 2020.0)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "INSPIRE Data Specification on Coordinate Reference Systems (D2.8.I.1)",
        "title": "INSPIRE CRS Technical Guidelines: ETRS89 horizontal, EVRS vertical",
        "access": "full_text_verified",
        "region": "European Union",
        "edition": "TG v3.2rc2 (release 2024.1)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "RFC 7946",
        "title": "The GeoJSON Format",
        "access": "full_text_verified",
        "clause": "s 4",
        "region": "International",
        "edition": "August 2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "NZGD2000 / NZTM2000 / NZVD2016",
        "title": "New Zealand Geodetic Datum 2000, NZ Transverse Mercator 2000, NZ Vertical Datum 2016 (NZGeoid2016)",
        "access": "full_text_verified",
        "region": "New Zealand",
        "edition": "NZGD2000 (1998); NZVD2016 (2016)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "OSGB36 / ETRS89 / OSTN15 / OSGM15 (ODN)",
        "title": "Ordnance Survey National Grid, ETRS89 and the definitive transformations",
        "access": "full_text_verified",
        "region": "United Kingdom",
        "edition": "OSTN15 / OSGM15",
        "checked_on": "2026-09-14"
      },
      {
        "code": "PAS 128:2022",
        "title": "Specification for underground utility detection, verification and location",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "2022 (2nd ed.)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASCE/UESI/CI 38-22",
        "title": "Standard Guideline for Investigating and Documenting Existing Utilities",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASCE/UESI/CI 75-22",
        "title": "Standard Guideline for Recording and Exchanging Utility Infrastructure Data",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "NAD 83(2011) / NAVD 88 (NSRS)",
        "title": "US official horizontal and vertical datums, being replaced by NATRF2022 et al.",
        "access": "full_text_verified",
        "region": "United States",
        "edition": "NAD 83 (2011/PA11/MA11) epoch 2010.00; NAVD 88",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Subsurface utilities on a site, with their AS 5488 quality level.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/utility_location/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/demiton-io-utility_location-v1"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.