---
schema_version: "1"
id: 846139c05b3785ab70896d08cd41cf56eaa6406d42f757add281da9d740b80e9
title: Replicated 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_replicateddatasets.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_replicateddatasets.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e627749b9a1f19f2b10d464a903e690629b4218debac9c14fe19dd9f034e4a79
description: Returns a list of replicated datasets, also know as connected objects.
---
# Replicated Datasets List Resource

Returns a list of replicated datasets, also know as connected objects.

## Resource URL

/wave/replicatedDatasets

## Formats

JSON

## Available Version

37.0

## Available in Postman

To view and test a working example of this resource, see [getReplicatedDatasetCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-4d63c328-18e7-42e1-9b32-1ab5a4c47a8a?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 getReplicatedDatasets()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-replicated-datasets.html)
- LWC — [lightning/analyticsWaveApi createReplicatedDataset()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-create-replicated-dataset.html)

## HTTP Methods

GET POST

## Request parameters for GET

<table class="featureTable sort_table" summary="">





          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d295913e141">Parameter Name</th>

              <th class="featureTableHeader vertical-align-top " id="d295913e144">Type</th>

              <th class="featureTableHeader vertical-align-top " id="d295913e147">Description</th>

              <th class="featureTableHeader vertical-align-top " id="d295913e150">Required or Optional</th>

              <th class="featureTableHeader vertical-align-top " id="d295913e153">Available Version</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d295913e141" data-title="Parameter Name"><samp class="codeph nolang">category</samp></td>

              <td class="entry" headers="d295913e144" data-title="Type">Connect​Wave​Replicated​Dataset​Category​Enum</td>

              <td class="entry" headers="d295913e147" data-title="Description">The category for connected objects. Valid values are:
                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Input</samp></li>

                  <li class="li"><samp class="codeph nolang">Output</samp></li>

                </ul>

              </td>

              <td class="entry" headers="d295913e150" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d295913e153" data-title="Available Version">50.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d295913e141" data-title="Parameter Name"><samp class="codeph nolang">connector</samp></td>

              <td class="entry" headers="d295913e144" data-title="Type">String</td>

              <td class="entry" headers="d295913e147" data-title="Description">Filter the list of returned connected objects by specifying the name of an
                Analytics connector.</td>

              <td class="entry" headers="d295913e150" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d295913e153" data-title="Available Version">37.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d295913e141" data-title="Parameter Name"><samp class="codeph nolang">include​Live</samp></td>

              <td class="entry" headers="d295913e144" data-title="Type">Boolean</td>

              <td class="entry" headers="d295913e147" data-title="Description">Indicates whether to include live datasets in the list (<samp class="codeph nolang">true</samp>)
                or not (<samp class="codeph nolang">false</samp>).</td>

              <td class="entry" headers="d295913e150" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d295913e153" data-title="Available Version">56.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d295913e141" data-title="Parameter Name"><samp class="codeph nolang">q</samp></td>

              <td class="entry" headers="d295913e144" data-title="Type">String</td>

              <td class="entry" headers="d295913e147" data-title="Description">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.</td>

              <td class="entry" headers="d295913e150" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d295913e153" data-title="Available Version">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d295913e141" data-title="Parameter Name"><samp class="codeph nolang">source​Object</samp></td>

              <td class="entry" headers="d295913e144" data-title="Type">String</td>

              <td class="entry" headers="d295913e147" data-title="Description">Filter the list of returned connected objects by specifying the name of a
                source object.</td>

              <td class="entry" headers="d295913e150" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d295913e153" data-title="Available Version">37.0</td>

            </tr>

          </tbody>

        </table>

## Response body for GET

[Replicated Dataset Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_replicated_dataset_collection.htm "A collection of Analytics replicated datasets, also know as connected objects.")

## Request body for POST

[Replicated Dataset Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_replicated_dataset_input.htm "An Analytics replicated dataset, also know as a connected object.")

The following JSON shows how to create a connected object from an Analytics connector.

{
  "connectorId": "0ItS7000000xxxxxxx",
  "sourceObjectName": "Account"
}

## Response body for POST

[Replicated Dataset](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_replicated_dataset.htm "An Analytics replicated dataset, also know as a connected object.")