---
title: "GET /datasets/{datasetId}/changesetsv2"
method: GET
path: "/datasets/{datasetId}/changesetsv2"
---

# GET /datasets/{datasetId}/changesetsv2

`GET /datasets/{datasetId}/changesetsv2`

Lists the FinSpace Changesets for a Dataset.

## Path parameters

- `datasetId` string, required — ID for a given Dataset

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListChangesetsResponse — Response to ListChangesetsResponse. This returns a list of dataset changesets that match the query criteria.
  - `changesets` ChangesetSummary[] — List of Changesets found.
    - `changesetId` string — The unique identifier for a Changeset.
    - `changesetArn` string — The ARN identifier of the Changeset.
    - `datasetId` string — The unique identifier for the FinSpace Dataset in which the Changeset is created.
    - `changeType` 'REPLACE' | 'APPEND' | 'MODIFY' — <p>Type that indicates how a Changeset is applied to a Dataset.</p> <ul> <li> <p> <code>REPLACE</code> – Changeset is considered as a replacement to all prior loaded Changesets.</p> </li> <li> <p> <code>APPEND</code> – Changeset is considered as an addition to the end of all prior loaded Changesets.</p> </li> <li> <p> <code>MODIFY</code> – Changeset is considered as a replacement to a specific prior ingested Changeset.</p> </li> </ul>
    - `sourceParams` object — Options that define the location of the data being ingested.
    - `formatParams` object — Options that define the structure of the source file(s).
    - `createTime` integer — The timestamp at which the Changeset was created in FinSpace. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.
    - `status` 'PENDING' | 'FAILED' | 'SUCCESS' | 'RUNNING' | 'STOP_REQUESTED' — <p>Status of the Changeset ingestion.</p> <ul> <li> <p> <code>PENDING</code> – Changeset is pending creation.</p> </li> <li> <p> <code>FAILED</code> – Changeset creation has failed.</p> </li> <li> <p> <code>SUCCESS</code> – Changeset creation has succeeded.</p> </li> <li> <p> <code>RUNNING</code> – Changeset creation is running.</p> </li> <li> <p> <code>STOP_REQUESTED</code> – User requested Changeset creation to stop.</p> </li> </ul>
    - `errorInfo` object — The structure with error messages.
      - `errorMessage` string — The text of the error message.
      - `errorCategory` 'VALIDATION' | 'SERVICE_QUOTA_EXCEEDED' | 'ACCESS_DENIED' | 'RESOURCE_NOT_FOUND' | 'THROTTLING' | 'INTERNAL_SERVICE_EXCEPTION' | 'CANCELLED' | 'USER_RECOVERABLE' — <p>The category of the error.</p> <ul> <li> <p> <code>VALIDATION</code> – The inputs to this request are invalid.</p> </li> <li> <p> <code>SERVICE_QUOTA_EXCEEDED</code> – Service quotas have been exceeded. Please contact AWS support to increase quotas.</p> </li> <li> <p> <code>ACCESS_DENIED</code> – Missing required permission to perform this request.</p> </li> <li> <p> <code>RESOURCE_NOT_FOUND</code> – One or more inputs to this request were not found.</p> </li> <li> <p> <code>THROTTLING</code> – The system temporarily lacks sufficient resources to process the request.</p> </li> <li> <p> <code>INTERNAL_SERVICE_EXCEPTION</code> – An internal service error has occurred.</p> </li> <li> <p> <code>CANCELLED</code> – Cancelled.</p> </li> <li> <p> <code>USER_RECOVERABLE</code> – A user recoverable error has occurred.</p> </li> </ul>
    - `activeUntilTimestamp` integer — Time until which the Changeset is active. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.
    - `activeFromTimestamp` integer — Beginning time from which the Changeset is active. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.
    - `updatesChangesetId` string — The unique identifier of the Changeset that is updated.
    - `updatedByChangesetId` string — The unique identifier of the updated Changeset.
  - `nextToken` string — A token that indicates where a results page should begin.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — AccessDeniedException
- `485` — ConflictException

---

[API](https://skmtc.net/aws/apis/finspace-data.md) · [All operations](https://skmtc.net/aws/apis/finspace-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/finspace-data/versions/d7561d153837/schema)