---
schema_version: "1"
id: 50b6b769c03cfe15f5814ada650934c494910b259f7bc91b9191b6fa2495c316
title: |-
  Einstein Discovery
      REST API Resources Overview
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest_sdd/bi_rest_sdd_resources_overview.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_rest_sdd_resources_overview.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8c6cb0286451fa1657f39aff9958419f759ba410e9ab211f4f873cd9ebd67de7
description: The Einstein Discovery REST API provides resources so you can access your Einstein Discovery insights.
---
# Einstein Discovery REST API Resources Overview

The Einstein Discovery REST API provides resources so you can access your Einstein Discovery insights.

All Einstein Discovery REST API resources are accessed using:

- A base URL for your company (for example, https://yourInstance.salesforce.com)
- Version information (for example, /services/data/v53.0)
- A named resource (for example, /smartdatadiscovery)

Put together, an example of the full URL to the resource is:

https://yourInstance.salesforce.com/services/data/v55.0/smartdatadiscovery

Org and Object Identifiers

Id fields in Salesforce, and for Einstein Discovery, are typically 15-character, base-62, case-sensitive strings. However, many Salesforce APIs, including the Einstein Discovery REST API, use 18-character, case-insensitive strings—for example, the Id property of the Story resource /smartdatadiscovery/stories/<storyID>. The last 3 digits are a checksum of the preceding 15 characters. The use of case-insensitive Id’s eases interaction with external applications and development environments that use case-insensitive references. To convert an 18-character Id back to a 15-character ID, simply remove the last 3 characters.

General Resources

General resources for Einstein Discovery are covered here, while specific features like prediction definitions and stories have their own sections.

| Resource | Description | Supported HTTP Method | Resource URL |
| --- | --- | --- | --- |
| [Metrics Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_metrics.htm "Returns the metrics collection for Einstein Discovery.") | Returns the metrics for Einstein Discovery. | GET | /smartdatadiscovery/metrics |
| [Narrative Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_narrative.htm "Returns the narrative data for an Einstein Discovery story.") | Returns the narrative data for an Einstein Discovery story. | POST | /smartdatadiscovery/narrative |
| [Predict Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_predict.htm "Make an Einstein Discovery prediction.") | Creates an Einstein Discovery prediction. | POST | /smartdatadiscovery/predict |
| [Predict History Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_predict_history.htm "Query the history of Einstein Discovery predictions.") | Query the history of Einstein Discovery predictions. | POST | /smartdatadiscovery/predict-history |
| [Smart Data Discovery Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_smart_data_discovery.htm "Lists the top-level resources available for Einstein Discovery.") | Lists the top-level resources available for Einstein Discovery. | GET | /smartdatadiscovery |

## Filtering REST Responses

In addition to Einstein Discovery REST API input parameters, you can use the following Connect REST API input parameters to filter the results returned from a request: filterGroup, external, and internal. For more information, 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.