The telematics device state data includes both a reported and a desired state:

The reported state represents how the device is actually configured.
- You will find information about the telematics device including, CAN profile details, attached devices as access control

Illustrative example

{
  "id": "abcdfg-b243-4398-a669-c28a11c48b25",
  "serialNumber": "10000000",
  "reported": {
    "accessControlDevice": {
      "serialNumber": "10000000",
      "type": "K300",
      "firmware": "2.1.5"
    },
    "canbus": {
      "can1": {
        "activityDetection": {
          "state": "ACTIVITY_DETECTED",
          "latest": {
            "state": "NO_ACTIVITY_DETECTED"
          }
        },
        "profile": {
          "name": "Profile 1",
          "id": 123
        }
      }
    },
    "firmware": {
      "version": "2.4.12"
    },
    "accessControl": {
      "mode": "UNLOCKED_FOR_KEY_AND_PIN"
    },
    "sensor": {
      "distance": {
        "offset": "0.0"
      }
    },
    "io": {
      "input1": {
        "name": "Input",
        "offset": "0"
      },
      "input2": {
        "name": "Input 2"
      },
      "input3": {
        "name": "Input 3"
      },
      "input4": {
        "name": "Input 4"
      }
    },
    "operatingMode": {
      "mode": "transport"
    },
    "wifi": {
      "profiles": [
        {
          "ssid": "MySSID",
          "securityType": "WPA2_PSK"
        }
      ]
    }
  },
  "desired": {
    "firmware": {
      "version": "2.4.12"
    },
    "canbus": {
      "can1": {
        "profile": {}
      }
    },
    "sensor": {
      "distance": {
        "offset": "0.0"
      }
    },
    "io": {
      "input1": {
        "name": "Input",
        "offset": "0"
      },
      "input2": {
        "name": "Input 2"
      },
      "input3": {
        "name": "Input 3"
      },
      "input4": {
        "name": "Input 4"
      }
    },
    "operatingMode": {
      "mode": "transport",
      "groupId": 0
    },
    "wifi": {
      "profiles": [
        {
          "ssid": "MySSID",
          "securityType": "WPA2_PSK"
        }
      ]
    }
  },
  "metadata": {
    "reported": {
      "canbus": {
        "can1": {
          "activityDetection": {
            "updatedAt": "2024-04-23T15:39:20.538137641Z",
            "latest": {
              "updatedAt": "2025-06-10T11:50:32.274819720Z"
            }
          },
          "profile": {
            "updatedAt": "2025-04-23T08:01:07.924366635Z"
          }
        },
        "can2": {
          "activityDetection": {
            "updatedAt": "2024-04-23T15:39:20.539485739Z",
            "latest": {
              "updatedAt": "2025-07-08T13:52:40.646611197Z"
            }
          }
        }
      },
      "firmware": {
        "version": {
          "updatedAt": "2025-07-01T08:21:37.955095379Z"
        }
      },
      "accessControl": {
        "mode": {
          "updatedAt": "2024-03-14T10:18:10.311375198Z"
        }
      },
      "sensor": {
        "distance": {
          "offset": {
            "updatedAt": "2025-04-22T13:27:20.418892305Z"
          }
        }
      },
      "io": {
        "input1": {
          "name": {
            "updatedAt": "2025-06-03T12:41:41.401517095Z"
          },
          "offset": {
            "updatedAt": "2025-04-22T13:27:19.925414041Z"
          }
        },
        "input2": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.022290816Z"
          }
        },
        "input3": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.160072792Z"
          }
        },
        "input4": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.274969751Z"
          }
        }
      }
    },
    "desired": {
      "firmware": {
        "updatedAt": "2025-07-01T08:20:36.217842009Z",
        "gateway": "iris"
      },
      "canbus": {
        "can1": {
          "profile": {
            "updatedAt": "2025-04-22T13:27:19.411942977Z",
            "gateway": "iris",
            "updateCommandStatus": "COMPLETED",
            "updateCommandStatusUpdatedAt": "2025-04-23T08:01:07.88942733Z"
          }
        }
      },
      "sensor": {
        "distance": {
          "offset": {
            "updatedAt": "2025-04-22T13:27:20.418892305Z"
          }
        }
      },
      "io": {
        "input1": {
          "name": {
            "updatedAt": "2025-06-03T12:41:41.401517095Z"
          },
          "offset": {
            "updatedAt": "2025-04-22T13:27:19.925414041Z"
          }
        },
        "input2": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.022290816Z"
          }
        },
        "input3": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.160072792Z"
          }
        },
        "input4": {
          "name": {
            "updatedAt": "2025-04-22T13:27:20.274969751Z"
          }
        }
      }
    }
  }
}

Latest configuration attempts of a telematics device will be visible in the desired state. Currently it includes configuration states for the following:
- Bluetooth advertising
- CAN profile
- Input filtering
- Output mode
- Modbus profile
- Operating mode
- Input names
- Wifi
The desired and reported state might not show the same. This indicates that the desired state is being synchronised to the telematics device.
Reported state might also include additional information like:
- Activity Detection for canbus. This indicates if the Telematics Device has been wired to the canbus and is capable of sending CAN data.

Illustrative example

Following is some examples on how the state can be interpreted for a CAN Profile configuration.

{
    "reported": {
        "canbus": {
            "profile": {
                "name": "Profile 1",
                "id": 123
            }
        }
    },
    "desired": {
        "canbus": {
            "profile": {
                "name": "Profile 1",
                "id": 123
            }
        }
    }
}

Both the desired and reported state shows the same CAN Profile. This means that the last configured CAN Profile has been successfully deployed to the telematics device.

{
    "reported": {
        "canbus": {
            "profile": {
                "name": "Profile 1",
                "id": 123
            }
        }
    },
    "desired": {
        "canbus": {
            "profile": {
                "name": "Profile 2",
                "id": 456
            }
        }
    }
}

The desired and reported state shows a different CAN Profile. This means that the last configured CAN Profile is not the same as the actual CAN Profile on the telematics device. The desired state is still being synchronised and will eventually be deployed to the telematics device.

Be aware that telematics devices might be in areas with no network connectivity or in an operational state where it would be inappropriate to update. In these cases, synchronisations might take hours or even days. There’s no timeout and the telematics device will be updated when possible.

➡️
OpenAPI Specification for the Telematics Device API domain
Get the OpenAPI Specification (formerly Swagger), which is a standardized format that describes the functionalities, endpoints, parameters, and data models of this API in a JSON file here.

200Desired and reported states of a device

400Bad request

401Invalid or missing bearer token in Authorization header

403User not allowed to make this request

404Resource not found

500Internal server error