---
title: "Get the version history for a dataset."
method: GET
path: "/api/Dataset/{datasetId}/history"
tags: ["Dataset Management"]
---

# Get the version history for a dataset.

`GET /api/Dataset/{datasetId}/history`

Returns the version history for a dataset, ordered by version number descending. Supports pagination and search.

## Path parameters

- `datasetId` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `search` string

## Response `200`

OK

- DatasetVersionResponseModelPaginationResponseModel — Paginated response wrapper containing a page of results along with pagination metadata.
  - `offset` integer — The offset from the first item in the results. For example, 20 indicates that this batch of results starts with the 21st result.
  - `limit` integer — The number of items the request limited the search to. The number of returned items can be less than the limit if not enough items exist or match the filter criteria.
  - `pageNumber` integer — The number for this page of the results, starting at 1.
  - `totalPages` integer — The total number of pages in the results.
  - `totalRecords` integer — The total number of records in the results.
  - `absoluteTotalRecords` integer — The absolute total number of records available (unfiltered). This represents the total count without any search or filter applied.
  - `hasPreviousPage` boolean — Whether there is a previous page of results.
  - `hasNextPage` boolean — Whether there is a next page of results.
  - `records` DatasetVersionResponseModel[], required — An array of returned records.
    - `versionNumber` integer
    - `createdDate` Instant — A point in time represented as an ISO 8601 timestamp string.
    - `user` UserEntityModel — A user entity with basic identity information.
      - `id` string, required — The unique identifier of the user or group.
      - `userName` string, nullable, required — The display name of the user or group.
      - `firstName` string, nullable — The user's first name.
      - `lastName` string, nullable — The user's last name.
    - `changeDescription` string
    - `summary` DatasetVersionChangeSummary[]
      - `fields` string[] — The field(s) that changed. A single-element list for most changes, or multiple elements when a bulk operation applied the same value to many fields (e.g. GeneratorSetup keys all set to the same state).
      - `description` string — Human-readable description, e.g. "Renamed dataset from 'A' to 'B'"
      - `changeType` 'Details' | 'Output' | 'WordDocumentSettings' | 'PdfSettings' | 'DeidentificationSetting' | 'TagsUpdate' | 'SynthesisMetadataUpdate' | 'AllowListUpdate' | 'BlockListUpdate' | 'CustomPiiEntityActivation' | 'ModelBasedEntityActivation' | 'RtfSettings' | 'ConfidenceThresholdUpdate' | 'FormMappingUpdate'
      - `oldValue` string, nullable — Optional previous value for detailed display
      - `newValue` string, nullable — Optional new value for detailed display
    - `restoredFromVersion` integer, nullable
    - `isLatestVersion` boolean

## Other responses

- `404` — The dataset cannot be found

---

[API](https://skmtc.net/tonic/apis/textual-api.md) · [All operations](https://skmtc.net/tonic/apis/textual-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonic/textual-api/revisions/41da8739a690/schema)