---
title: "List dataset versions"
method: GET
path: "/v1/datasets/{datasetId}/versions"
tags: ["Datasets"]
---

# List dataset versions

`GET /v1/datasets/{datasetId}/versions`

## Request

- Base URL: `https://api.terranode.co`
- URL: `https://api.terranode.co/v1/datasets/{datasetId}/versions`
- Auth: API key in header `x-api-key`

Returns version history for a dataset, including feature counts and diffs between consecutive versions.

## Path parameters

- `datasetId` string, uuid, required

## Response `200`

Version history.

- VersionHistoryResponse
  - `datasetId` string, uuid, required
  - `currentVersion` integer, required
  - `versions` VersionEntry[], required
    - `version` integer, required
    - `createdAt` string, date-time, required
    - `features` integer, required
    - `diff` object
      - `added` integer
      - `removed` integer
      - `changed` integer
      - `unchanged` integer

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/terranode/apis/terranode-geospatial-api.md) · [All operations](https://skmtc.dev/terranode/apis/terranode-geospatial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/terranode/apis/terranode-geospatial-api/revisions/bdd80613bc7a?raw)