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

# GET /datasets/{datasetId}/changesetsv2/{changesetId}

`GET /datasets/{datasetId}/changesetsv2/{changesetId}`

Get information about a Changeset.

## Path parameters

- `datasetId` string, required — ID for a given Dataset
- `changesetId` string, required — ID used to identify a Changeset

## Response `200`

Success

- GetChangesetResponse — The response from a describe changeset operation
  - `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 where 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 — 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' — The status of Changeset creation operation.
  - `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 being updated.
  - `updatedByChangesetId` string — The unique identifier of the updated Changeset.

## 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/revisions/d7561d153837/schema)