v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB

Registry

Creates a license for a single physical device

Device license is a deviceId and deviceSecret credential pair. The created credentials will be returned in the response body.

If autoclaim query parameter is set to true, the created device will also be claimed by the same user account.

post/registry/v2/{appId}/one-device

Path parameters

appIdstring required

Project appId of the user's project

Query parameters

autoclaimboolean

If set to true, the device license is created and the device is immediately claimed by the same user.

Headers

X-Request-Idstring uuid

ID used for correlating requests within HERE Tracking. Used for logging and error reporting.

Must be a valid UUIDv4.

Response

Successful

deviceIdstring required

A newly created device ID.

deviceSecretstring

A newly created device secret. A physical device license is a deviceId and deviceSecret credential pair.

trackingIdstring

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

{
  "deviceId": "4cdafa38-fdf9-474c-8eb3-72ea276a163a",
  "deviceSecret": "AGIhZGmU1jJS-H1ZfAZuh5U9cswyqquWVrbOKGwKN9s",
  "trackingId": "HERE-6da0f871-b4eb-4800-90e6-4bae86a788d6"
}