Demiton · Schema

driving_behaviour_event contract v1

Harsh braking, acceleration and cornering events from telematics.

CompanyConstructionCivil EngineeringProject ManagementComplianceMCPArtificial IntelligenceOpen Contracting

Properties

Name Type Description
gps object the position carried on the event, and by the declared producer edge the geographic area it is attributed to
asset string the vehicle the event was recorded against
device number the telematics device that recorded the event
driver number the operator attributed to the event
category string which kind of event it is: harsh braking or harsh acceleration
duration_s number how long the event lasted (`attributes.duration`)
external_id string the source's own event identifier (`id`)
occurred_at string when the harsh braking/acceleration event occurred
acceleration_g number peak acceleration of an EA event, magnitude, INSTANTANEOUS
deceleration_g number peak deceleration of an HB event, magnitude, INSTANTANEOUS (never summed)
raw_attributes object the untouched source event payload, including the per-second acceleration/GPS trace the resource description promises
acceleration_threshold_g number the EA threshold the event exceeded (`maxAccelerationThrsh`)
deceleration_threshold_g number the HB threshold the event exceeded (`minDecelerationThrsh`)
View JSON Schema on GitHub

JSON Schema

demiton-io-driving_behaviour_event-v1-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/driving_behaviour_event/v1.json",
  "title": "driving_behaviour_event contract v1",
  "type": "object",
  "required": [
    "acceleration_g",
    "asset",
    "category",
    "deceleration_g",
    "external_id",
    "occurred_at"
  ],
  "properties": {
    "gps": {
      "type": "object",
      "description": "the position carried on the event, and by the declared producer edge the geographic area it is attributed to",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "— (datum, CRS and precision **unverified**)"
    },
    "asset": {
      "type": "string",
      "description": "the vehicle the event was recorded against",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "device": {
      "type": "number",
      "description": "the telematics device that recorded the event",
      "x-demiton-requiredness": "optional"
    },
    "driver": {
      "type": "number",
      "description": "the operator attributed to the event",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "category": {
      "type": "string",
      "description": "which kind of event it is: harsh braking or harsh acceleration",
      "x-demiton-requiredness": "required"
    },
    "duration_s": {
      "type": "number",
      "description": "how long the event lasted (`attributes.duration`)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "s",
      "x-demiton-type": "decimal"
    },
    "external_id": {
      "type": "string",
      "description": "the source's own event identifier (`id`)",
      "x-demiton-requiredness": "required"
    },
    "occurred_at": {
      "type": "string",
      "description": "when the harsh braking/acceleration event occurred",
      "x-demiton-requiredness": "required",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "acceleration_g": {
      "type": "number",
      "description": "peak acceleration of an EA event, magnitude, INSTANTANEOUS",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "g",
      "x-demiton-type": "decimal"
    },
    "deceleration_g": {
      "type": "number",
      "description": "peak deceleration of an HB event, magnitude, INSTANTANEOUS (never summed)",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "g",
      "x-demiton-type": "decimal"
    },
    "raw_attributes": {
      "type": "object",
      "description": "the untouched source event payload, including the per-second acceleration/GPS trace the resource description promises",
      "x-demiton-requiredness": "optional"
    },
    "acceleration_threshold_g": {
      "type": "number",
      "description": "the EA threshold the event exceeded (`maxAccelerationThrsh`)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "g",
      "x-demiton-type": "decimal"
    },
    "deceleration_threshold_g": {
      "type": "number",
      "description": "the HB threshold the event exceeded (`minDecelerationThrsh`)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "g",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "driving_behaviour_event",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "asset",
      "requirement": "required",
      "role": "subject"
    },
    {
      "axis": "financial_period",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [
    {
      "key": "acceleration_g",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "g"
    },
    {
      "key": "acceleration_threshold_g",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "g"
    },
    {
      "key": "deceleration_g",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "g"
    },
    {
      "key": "deceleration_threshold_g",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "g"
    },
    {
      "key": "duration_s",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "s"
    }
  ],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "GDA2020 / MGA2020",
        "title": "Geocentric Datum of Australia 2020 and Map Grid of Australia 2020 (EPSG:7844 / EPSG:78xx zones)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "GDA2020 = ITRF2014 at epoch 2020.0",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles",
        "access": "full_text_verified",
        "clause": "APP 3",
        "region": "Australia",
        "edition": "APP Guidelines ch 3 v1.2 (2026-05-13)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Workplace Surveillance Act 2005 (NSW)",
        "title": "Workplace Surveillance Act 2005 (tracking surveillance of employees)",
        "access": "public_summary",
        "clause": "s 10",
        "region": "Australia",
        "edition": "in force (compilation 2025-06-14)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Regulation (EU) 2016/679 (GDPR)",
        "title": "General Data Protection Regulation (GDPR)",
        "access": "public_summary",
        "region": "European Union",
        "edition": "2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 55001",
        "title": "Asset management - Asset management system - Requirements",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2024 (AS ISO 55001:2024 identical AU adoption)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO/TS 15143-3",
        "title": "Earth-moving machinery and mobile road construction machinery - Worksite data exchange - Telematics data (AEMP 2.0)",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2020 (SA TS ISO 15143.3:2021 AU and PD ISO/TS 15143-3:2020 UK identical adoptions)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "RFC 7946",
        "title": "The GeoJSON Format (IETF Proposed Standard)",
        "access": "full_text_verified",
        "region": "International",
        "edition": "August 2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ICO monitoring workers guidance",
        "title": "ICO Employment practices and data protection: monitoring workers",
        "access": "full_text_verified",
        "region": "United Kingdom",
        "edition": "current guidance (under review after the Data (Use and Access) Act)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "UK GDPR / Data Protection Act 2018",
        "title": "UK GDPR and Data Protection Act 2018",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "49 CFR Part 395 Subpart B",
        "title": "FMCSA - Hours of Service of Drivers - Electronic Logging Devices",
        "access": "full_text_verified",
        "clause": "s 395.26",
        "region": "United States",
        "edition": "current (ELD mandate from 2017-12-18)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Harsh braking, acceleration and cornering events from telematics.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/driving_behaviour_event/",
  "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-driving_behaviour_event-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.

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