---
schema_version: "1"
id: 57994bc0d974474b3b5e47bbeedf5171f996e1003c8e77fc9f7720b763520d4c
title: Story Query
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest_sdd/bi_sdd_responses_story_query.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_story_query.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: c7e034bf4f4424485bd98dd41fcda0d68d2bdfb684924f83fa94721af12123fb
description: A query for story insights.
---
# Story Query

A query for story insights.

Properties

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





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

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

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

                  <th class="featureTableHeader vertical-align-top " id="d158419e70">Filter Group and Version</th>

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

                </tr>

              </thead>

              <tbody class="tbody">
                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">descriptive​Insights</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type">
                    <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_abstract_story_insights.htm" title="The base story insights.">Abstract​Story​Insights</a>[]
                  </td>

                  <td class="entry" headers="d158419e67" data-title="Description">A list of descriptive story insights. Valid values are:
                    <ul class="ul bulletList">
                      <li class="li"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_story_first_order_insights.htm" title="The first order insights for a story.">Story​First​Order​Insights</a></li>

                      <li class="li"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_story_second_order_insights.htm" title="The second order insights for a story.">Story​Second​Order​Insights</a></li>

                    </ul>
                  </td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 52.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">52.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">diagnostic​Insights</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type">
                    <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_story_query_diagnostic_insights.htm" title="A story query diagnostic insights.">Story​Query​Diagnostic​Insights</a>[]
                  </td>

                  <td class="entry" headers="d158419e67" data-title="Description">A list of diagnostic story insights.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 53.0</td>

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

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">include​Chart</samp></td>

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

                  <td class="entry" headers="d158419e67" data-title="Description">Indicates whether to include the story chart in the query response (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">include​Narrative</samp></td>

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

                  <td class="entry" headers="d158419e67" data-title="Description">Indicates whether to include the story narrative in the query response (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">include​Regular​Fields</samp></td>

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

                  <td class="entry" headers="d158419e67" data-title="Description">Indicates whether to include regular fields in the query response (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">include​Sensitive​Fields</samp></td>

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

                  <td class="entry" headers="d158419e67" data-title="Description">Indicates whether to include sensitive fields in the query response (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">limit</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type">Integer</td>

                  <td class="entry" headers="d158419e67" data-title="Description">The total number of insight cards in the query response.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">offset</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type">Integer</td>

                  <td class="entry" headers="d158419e67" data-title="Description">The insight card offset value.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 54.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">54.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">query</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_story_query_input_parameter.htm" title="The input parameter for a story query.">Story​Query​Input​Parameter</a></td>

                  <td class="entry" headers="d158419e67" data-title="Description">The story query input parameters.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 52.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">52.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">total​Size</samp></td>

                  <td class="entry" headers="d158419e64" data-title="Type">Integer</td>

                  <td class="entry" headers="d158419e67" data-title="Description">The total insight count for the story.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 52.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">52.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d158419e61" data-title="Property Name"><samp class="codeph nolang">url</samp></td>

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

                  <td class="entry" headers="d158419e67" data-title="Description">The URL for the story query.</td>

                  <td class="entry" headers="d158419e70" data-title="Filter Group and Version">Small, 52.0</td>

                  <td class="entry" headers="d158419e73" data-title="Available Version">52.0</td>

                </tr>

              </tbody>

            </table>