Live tracking report

Use the Live Tracking report to retrieve current driver tracking data and integrate it into internal dashboards or control-tower-style maps.

Request a live tracking report

To return an organization-wide report of current Live Tracking data, send a GET request to the tracking report endpoint.

Add the API key and authorization token that you received during setup.

Sample request using cURL:

curl -X GET \
  "https://api.wego.hereapi.com/user-service/users/tracking/report?apiKey=YOUR_WEGO_PRO_API_KEY" \
  -H "Authorization: Bearer YOUR_ADMIN_ACCESS_TOKEN" \
  -H "Accept: application/json"

The service validates the following:

API key validity and permission to call user-service
Access token validity and user role
If the request is valid, the API returns a JSON array of tracking records.

Sample response

The following sample shows the structure of a tracking report response. Each object in the array represents one tracked device.

[
  {
    "email": "[email protected]",
    "hereAccountUserId": "HERE-12345678-90ab-cdef-1234-567890abcdef",
    "subscriptionKey": "sub-0e3ad78d-0de7-41e4-8391-2b2b4138560b",
    "deviceId": "42b3a3f6-8d2e-4c11-bafc-0a68f24e7dc9",
    "currentLocation": {
      "lat": 52.0,
      "lon": -1.5
    },
    "waypoints": [
      {
        "eta": "2024-01-11T11:38:15Z",
        "lat": 53.0,
        "lon": -2.5
      }
    ],
    "modifiedAt": "2024-03-22T15:43:11Z"
  }
]

Response fields

Field	Description
email	Driver’s HERE account email address. Use this field to link the device or position to a specific user.
hereAccountUserId	Internal HERE user identifier. This is useful for system-to-system integrations.
subscriptionKey	HERE WeGo Pro subscription associated with the device.
deviceId	Unique device ID that HERE WeGo Pro uses to distinguish phones and tablets.
currentLocation	Last known geographic coordinates of the device.
currentLocation.lat	Latitude of the device’s last known location.
currentLocation.lon	Longitude of the device’s last known location.
waypoints[]	Upcoming stops and ETAs. If there is no active route or no ETA data, this array may be empty.
waypoints[].eta	Estimated time of arrival at the waypoint, in ISO 8601 format.
waypoints[].lat	Latitude of the waypoint.
waypoints[].lon	Longitude of the waypoint.
modifiedAt	Timestamp, in ISO 8601 format, when the record was last updated. Use this field to determine whether the location data is recent.