--- schema_version: "1" id: a6df5ae365bc4ec7872eed19fd2414a2599ba1b3ac7d5eb96865523ef3021f48 title: Datasets 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.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_datasets.htm source_site: developer.salesforce.com content_type: documentation content_hash: fcee701de8a94e018fa9ea0f5a7e9ea9350b854985e7ec5e11554ae86c9bc5bc description: Returns a collection of Analytics dataset and creates a dataset. --- # Datasets List Resource Returns a collection of Analytics dataset and creates a dataset. ## Resource URL /wave/datasets ## Formats JSON ## Available Version GET 36.0 POST 50.0 ## Available in Postman To view and test a working example of this resource, see [getDatasetCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-0850900b-70ff-4536-9b86-11cf3dee9d57?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 - Aura — [ listDatasets()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_asset.htm) - LWC — [lightning/analyticsWaveApi getDatasets()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-datasets.html) ## HTTP Methods GET POST ## GET Request Parameters

Parameter Name	Type	Description	Required or Optional	Available Version
`createdAfter`	String	Filters the results to include only the contents created after a specific timestamp.	Optional	56.0
`createdBefore`	String	Filters the results to include only the contents created before a specific timestamp.	Optional	56.0
`datasetTypes`	ConnectWaveDatasetTypeEnum	The type of the dataset. Valid values are: `Default` `Live` `StagedData` `Trended`	Optional	50.0
`folderId`	ID	Filters the results to include only the contents of a specific folder. The id can be the requesting user’s ID for items in the user’s private folder.	Optional	36.0
`hasCurrentOnly`	Boolean	Indicates whether to filter the list of datasets to include only those datasets that have a current version (`true`) or not (`false`). The default is `false`.	Optional	52.0
`ids`	ID[]	Filter the list of datasets to include only datasets with the specified ids.	Optional	53.0
`includeCurrentVersion`	Boolean	Indicates whether to include the current dataset version metadata in the collection (`true`) or not (`false`). The default is `false`.	Optional	52.0
`lastQueriedAfter`	String	Filters the results to include only the contents last queried after a specific timestamp.	Optional	56.0
`lastQueriedBefore`	String	Filters the results to include only the contents last queried before a specific timestamp.	Optional	56.0
`licenseType`	ConnectAnalyticsLicenseTypeEnum	Filters the collection by the Analytics license type. Valid values are: `Cdp` (Data 360) `DataPipelineQuery` (Data Pipeline Query) `EinsteinAnalytics` (CRM Analytics) `IntelligentApps` (Intelligent Apps) `Sonic` (Salesforce Data Pipeline)	Optional	52.0
`order`	Enum	Ordering applied to the results. Valid values are: `Ascending` `Descending`	Optional	42.0
`page`	String	A generated token that indicates the view of datasets to be returned.	Optional	36.0
`pageSize`	Int	The number of items to be returned in a single page. Minimum is 1, maximum is 200, and default is 25.	Optional	36.0
`q`	String	Search terms. Individual terms are separated by spaces. A wildcard is automatically appended to the last token in the query string. If the user’s search query contains quotation marks or wildcards, those symbols are automatically removed from the query string in the URI along with any other special characters.	Optional	36.0
`scope`	ConnectWaveScopeTypeEnum	The type of scope to be applied to the returned collection. Valid values are: `Browse` `CreatedByMe` `InsightsApplicationsIsCansEdit` `Mru` (Most Recently Used) `SharedWithMe`	Optional	38.0
`sort`	ConnectWaveDatasetSortOrderTypeEnum	The type of sort order to be applied to the returned dataset collection. Valid values are: `ConnectionName` (only valid if the dataset is a Live Dataset) `CreatedBy` `CreatedDate` `LastArchivedBy` `LastArchivedDate` `LastModified` `LastQueried` `LastRefreshed` `Mru` (Most Recently Used, last viewed date) `Name` `TotalRows`	Optional	38.0
`supportsNewDates`	Boolean	Indicates whether to filter the list of datasets to include only those datasets that support new dates (`true`) or not (`false`). The default is `false`.	Optional	52.0
`typeOfDataflow`	String	Filters the list of datasets to include only those datasets that have the specified type of dataflow.	Optional	61.0

You can filter the results to include only those datasets that have a current dataset version defined by using the hasCurrentOnly parameter. You can also request supplemental information about datasets that have a current dataset version defined by using the filterGroup parameter. For example, the following GET request sets these parameters: /wave/datasets?hasCurrentOnly=true&filterGroup=Supplemental This request filters the list of datasets and adds the following supplemental fields to the output representation: - currentVersionCreatedBy - currentVersionCreatedDate - currentVersionLastModifiedBy - currentVersionLastModifiedDate For more information about the filterGroup parameter, see [Specifying Response Sizes](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_returns_filters.htm) in the Connect REST API Developer Guide. ## Response body for GET [Dataset Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_dataset_collection.htm "A collection of datasets.") ## Request body for POST [Dataset Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_dataset_input.htm "An Analytics dataset.") ## Response body for POST [Dataset](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_dataset.htm "An Analytics dataset.")