---
title: "Get Changesets"
method: GET
path: "/spaces/{spaceId}/changesets"
tags: ["Manage Changesets"]
---

# Get Changesets

`GET /spaces/{spaceId}/changesets`

Retrieves a subset of existing Changesets from the space's history. The subset can be defined either by a "startVersion" and an "endVersion" or by providing a version ref that references a version range e.g., "5..6" or "0..HEAD"

Each successful write transaction to the space is stored as one single Changeset, which can contain modifications applied to one or more features.

The response payload may be split in multiple pages. The next page token is written in the property 'nextPageToken', which then can be used to retrieve the next page using the 'pageToken' parameter on the next call.

## Path parameters

- `spaceId` string, required

## Query parameters

- `versionRef` string
- `startVersion` integer
- `endVersion` integer
- `pageToken` string
- `limit` integer

## Response `200`

A collection of Changesets which contains FeatureCollections grouped by operation.

## Other responses

- `400` — Malformed or Bad Request.
- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.
- `404` — Not found.
- `513` — Response payload too large.

## Changes

- **2025-08-10** `a5a97b4943e2` — 1 info
  - added the new optional `query` request parameter `versionRef`
- **2024-09-24** `c39c865eea00` — 2 info
  - the `query` request parameter `endVersion` became optional
  - the `query` request parameter `startVersion` became optional
- **2024-09-19** `409ef8fb277a` — 1 warning, 1 info
  - removed the optional property `versions/additionalProperties/updatedAt` from the response with the `200` status
  - added the optional property `versions/additionalProperties/createdAt` to the response with the `200` status
- **2024-09-18** `a8709c5fe133` — 1 warning, 1 info
  - removed the optional property `versions/additionalProperties/createdAt` from the response with the `200` status
  - added the optional property `versions/additionalProperties/updatedAt` to the response with the `200` status
- **2024-02-05** `539d9580be99` — 1 breaking
  - for the `query` request parameter `versionRef`, default value `main:HEAD` was added

[Full history](https://skmtc.dev/here/apis/here-xyz-hub/changes/spaces/:spaceId/changesets/get.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-hub/revisions/a5a97b4943e2?raw)