---
schema_version: "1"
id: a8ef8dd3d54a60beccbed4a72aeebebdc8fff7d78b54c45e0920145ea37cc9fc
title: Dataset Versions List Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_datasets_id_versions.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_datasets_id_versions.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: cfe59a6230c8ddffebe7d792a12f85b4ace0259b56af333fbc003dbc466a97e8
description: Returns a list of dataset versions for a particular dataset or creates a version.
---
# Dataset Versions List Resource

Returns a list of dataset versions for a particular dataset or creates a version.

## Resource URL

/wave/datasets/<datasetIdOrApiName>/versions

## Formats

JSON

## Available Version

36.0

## Available in Postman

To view and test a working example of this resource, see [getDatasetVersionCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-6e4b4e2a-8fc3-4cec-afac-0aa38318451c?action=share&source=copy-link&creator=26106753 "HTML (New Window)") in Postman. For information about how to authenticate your org with Postman, see the [CRM Analytics Rest API Quick Start](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/crma_rest_api_quick_start.htm "Connect to a Salesforce Trailhead org and authenticate. Then make a request to the CRM Analytics REST API in Postman, and look at the response.").

## Available Components

- LWC — [lightning/analyticsWaveApi getDatasetVersions()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-dataset-versions.html)
- LWC — [lightning/analyticsWaveApi createDatasetVersion()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-create-dataset-version.html)

## HTTP Methods

GET POST

## GET Request Parameters

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| created​After | String | Filters the results to include only dataset versions created after a specific timestamp. | Optional | 62.0 |
| created​Before | String | Filters the results to include only dataset versions created before a specific timestamp. | Optional | 62.0 |
| include​Archived | Boolean | Filters the results to include archived dataset versions (true) or not (false). | Optional | 62.0 |

## Response body for GET

[Dataset Version Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_dataset_version_collection.htm "A collection of versions for an Analytics dataset.")

## Request body for POST

[Restore Dataset Version Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_restore_dataset_version_input.htm "A specific version to restore an Analytics dataset to.")

## Response body for POST

[Restore Dataset Version](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_restore_dataset_version.htm "The message returned for an Analytics data connector ingest request or an Analytics dataset version update request.")