v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB

Ingestion

Ingests data for multiple devices

Device owner use this endpoint to ingest data to HERE Tracking on behalf of multiple devices.

A single request can contain data for multiple devices. The devices can be either real or virtual. A real device is identified by a trackingId assigned to it when the device was claimed. A virtual device is identified by an external device ID and the owner's project appId.

Prior to making the request, the device owner should first authenticate himself with HERE Tracking and obtain a user access token. The user access token will then be used in this API call.

For more information on the device position resolution, and the device shadow and trace updates, see the /v3 endpoint description.

post/v3/batch

Headers

X-Request-Idstring uuid

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

Must be a valid UUIDv4.

authorizationstring required

Request body

appIdstring

The user's project appId. Used together with an external ID to identify the virtual devices.

Example request

{
  "appId": "MyAppId123",
  "data": [
    {
      "id": "MyDevice1",
      "scan": {
        "gsm": [
          {
            "cid": 16504,
            "lac": 5126,
            "mcc": 262,
            "mnc": 1,
            "nmr": [
              {
                "bcch": "82",
                "bsic": "6"
              },
              {
                "bcch": "85",
                "bsic": "7"
              },
              {
                "bcch": "93",
                "bsic": "12"
              },
              {
                "bcch": "88",
                "bsic": "13"
              },
              {
                "bcch": "88",
                "bsic": "19"
              }
            ]
          }
        ]
      },
      "timestamp": 1515169948976
    },
    {
      "id": "MyDevice2",
      "payload": {
        "sensor": "data"
      },
      "scan": {
        "wlan": [
          {
            "mac": "1c:1d:86:07:01:0f",
            "powrx": -45
          },
          {
            "mac": "e4:f4:c6:d9:85:59",
            "powrx": -39
          },
          {
            "mac": "1c:1d:86:07:01:0d",
            "powrx": -43
          },
          {
            "mac": "1c:1d:86:07:01:0b",
            "powrx": -44
          },
          {
            "mac": "1c:1d:86:07:01:04",
            "powrx": -58
          },
          {
            "mac": "1c:1d:86:07:01:03",
            "powrx": -59
          }
        ]
      },
      "timestamp": 1515169948976
    }
  ]
}

Response

Successful (no content)

The device data was ingested successfully.