Sign in

v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
Transitions

Gets transitions for a device

Gets all transitions that were recorded within a specific time range. Define the range with before and after parameters. The returned transitions are listed in descending order based on their timestamps.

Note:

By default, the after parameter value is 0, and the before parameter is set to the current system time. Always make sure to specify before and after parameters explicitly, as otherwise it may take a very long time for an API call to complete.

The count and pageToken parameters are used for pagination.

get/transitions/v2/devices/{trackingId}

Path parameters

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.

Query parameters

appIdstring

Application identifier. Used together with an external ID to identify a virtual device.

beforenumber

Milliseconds elapsed since 1 January 1970 00:00:00 UTC. The accepted range is from 1 to the current time.

afternumber

Milliseconds elapsed since 1 January 1970 00:00:00 UTC. The accepted range is from 0 to the current time.

pageTokenstring

A token from the previously returned response to retrieve the specified page.

countinteger

The number of items to return per page.

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

The response body contains an array of transitions, count is the number of returned items and pageToken is the next page token if available.

If no transitions are found, an object with an empty data array is returned.

Transitions are sorted in descending order based on their timestamps.

countinteger

The number of items in the response.

pageTokenstring

A token that can be used to retrieve the next page of the response.

Example response

{
  "count": 2,
  "data": [
    {
      "geofenceId": "e2f651ee-f196-4fa3-bf88-894dc131dea3",
      "inOut": "PING_OUTSIDE_FENCE",
      "notificationStatus": "SENT",
      "timestamp": 1499258184142,
      "trackingId": "HERE-871eb4c9-76f6-4e9d-bed7-fa114f793e83"
    },
    {
      "geofenceId": "e2f651ee-f196-4fa3-bf88-894dc131dea3",
      "inOut": "PING_IN_FENCE",
      "notificationStatus": "NOT_SENT",
      "timestamp": 1499258057035,
      "trackingId": "HERE-871eb4c9-76f6-4e9d-bed7-fa114f793e83"
    }
  ],
  "pageToken": "1234abcd"
}