Claim ownership of a device

In order to control and access the data created by the device, the first step is to claim the device. This allows the device data to be saved in HERE Tracking.

Claim a device to a project


  • Valid deviceId and deviceSecret that have not yet been added to a user account
  • Valid user account (member of a project)

Log the user in

curl -X POST \ \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "{userEmail}",
    "password": "{userPassword}"

This will return an accessToken.

Add the device to the project

If you are a member of multiple projects, please specify the Project ID in the projectId -query parameter.

curl -X PUT \{deviceId} \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

This will return a trackingId. This is the unique identifier associated with the data in HERE Tracking.

NOTE: This is different from the deviceId used in the licence. The deviceId is permanently associated with the hardware, the trackingId is associated with the data. If the device is later sold or transferred, the deviceId remains the same but the trackingId changes.

Verify the device is in the user's list of devices

curl -X GET \ \
  -H 'Authorization: Bearer {accessToken}'

results matching ""

    No results matching ""