---
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 of
a specific branch: e.g., "main:5..6" or "myBranch:0..HEAD".


The version range can be specified using the `versionRef` query-parameter as follows:
`<start>..<end>`

Where `<start>` is the start of the range (exclusive) and `<end>` is the end of the range
(inclusive).


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
- `author` string
- `startTime` integer
- `endTime` 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.

---

[API](https://skmtc.net/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.net/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)