How to get all changesets

Each successful write transaction to an interactive map layer is stored as a single changeset, which can contain modifications applied to one or more features.

The following request retrieves all existing changesets from the interactive map layer using "startVersion" and "endVersion" query parameters to define the number of versions of the layer to read.

The response payload may be split into multiple pages, with the next page written in the property 'nextPageToken', which can be retrieved using the 'pageToken' parameter.

GET /<Base path for the interactive API from the API Lookup Service>/layers/{layerId}/changesets
Host: <Hostname for the interactive API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

Which returns the following sample response:

{
  "type": "ChangesetCollection",
  "startVersion": 1,
  "endVersion": 2,
  "versions": {
    "1": {
      "type": "Changeset",
      "inserted": {
        "type": "FeatureCollection",
        "features": [
          {
            "type": "Feature",
            "id": "Q1369587",
            "geometry": {
              "type": "Point",
              "coordinates": [
                -62.696667,
                8.3125
              ]
            },
            "properties": {
              "name": "Polideportivo Cachamay",
              "@ns:com:here:xyz": {
                "version": 1
              },
              "sport": "association football",
              "capacity": 41600
            }
          }
        ]
      },
      "updated": {
        "type": "FeatureCollection",
        "features": [
          {
            "type": "Feature",
            "id": "Q947065",
            "geometry": {
              "type": "Point",
              "coordinates": [
                -110.948889,
                32.228889
              ]
            },
            "properties": {
              "name": "Arizona Stadium",
              "@ns:com:here:xyz": {
                "version": 1
              },
              "sport": "American football",
              "capacity": 56037
            }
          }
        ]
      },
      "deleted": {
        "type": "FeatureCollection",
        "features": []
      }
    }
  },
  "nextPageToken": 1000
}

📘
Note
You can alternatively use an API Key instead of an OAuth bearer token in an authorization header.