Sign in

v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
Registry

Claims a device

Claims a device, associating a device to a user account. The user who claimed a device is the device owner, which is different from the device vendor.

Unclaimed devices cannot login or send any data to HERE Tracking. A claimed device data is stored in HERE Tracking and is available to the device owner's project, which the device has been claimed to.

When a device is claimed, it gets assigned a trackingId. This is a unique ID associated with the device data in HERE Tracking.

trackingId is different from the deviceId. The deviceId is permanently associated with the hardware, while the trackingId is associated with the device data. If the device is later sold or transferred, the deviceId remains the same but the trackingId changes in case the device is reclaimed. This way the new owner cannot access the old data.

If the user is a member of multiple projects, the target project ID needs to be specified in the projectId query parameter (note that this is different from the appId).

Only users with a valid HERE Tracking license are authorized to claim new devices. Claimed devices are associated with the owner application ID, and the total device count is kept up-to-date for billing purposes.

put/registry/v2/devices/{deviceOrExternalId}

Query parameters

projectIdstring

Project ID. Any HERE Tracking user must be a member of a Tracking project. The project ID can be implicitly resolved if the user calling the API is a member of a single project. If the user is a member of multiple projects, the projectId query parameter needs to be specified explicitly.

Request body

ownerAppIdstring

(Deprecated) Application identifier which specifies device owner's application to which the device is associated with.

Response

Already claimed by the same user

trackingIdstring required

This is a unique ID associated with the device data in HERE Tracking. For physical devices the trackingId gets assigned to a device when the device is claimed by a user, and for virtual devices it is an external device ID along with the device project appId.

Example response

{
  "trackingId": "HERE-6da0f871-b4eb-4800-90e6-4bae86a788d6"
}