---
cuppy_hub: salesforce
cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-insights-ci-ci-name.md
cuppy_section: docs
cuppy_doc: PAQP-ES19
cuppy_doc_uuid: 14a47794-6833-45e3-85d8-6c93b49756bd
cuppy_permalink: https://cuppy.io/salesforce/d/PAQP-ES19
cuppy_version: 1
cuppy_updated: 2026-10-23T16:16:52.575Z
cuppy_canonical: https://cuppy.io/salesforce/docs/reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-insights-ci-ci-name
cuppy_mcp: https://cuppy.io/mcp
cuppy_body_sha256: 598cfcb678b14e2eaa9a364047456c898c1155cfe1a8c6484fa8ec8cb924df8e
# cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks.
---

> Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-insights-ci-ci-name.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

## Get Calculated Insight Data

Queries a specific calculated insight in your Data 360 instance. This endpoint allows you to retrieve data with customizable dimensions, measures, filters, and time-based aggregations.

*   **HTTP Method**: GET
*   **Availability**: Data 360 v1.0, Salesforce v51.0
*   **Format**: REST
*   **URI**: `/api/v1/insight/calculated-insights/{ci-name}`

| Parameter | Type | Description |
| --- | --- | --- |
| ci-name | string | Required. The unique identifier of the calculated insight. Example: `Avg_Spends__cio` |

| Parameter | Type | Description |
| --- | --- | --- |
| dimensions | string | Comma-separated list of dimensions to include in the response. Default: all available dimensions. Example: `GenderId__c,FirstName__c` |
| measures | string | Comma-separated list of measures to include in the response. Default: all available measures. Example: `TotalSales__c,AvgSpend__c` |
| limit | integer | Maximum number of rows to return. Default: 4,999. Example: `1000` |
| offset | integer | Number of rows to skip before returning results. Example: `100` |
| filters | string | Filter criteria in the format `[field=value]`. Example: `[GenderId__c=Male,FirstName__c=John]` |
| orderby | string | Comma-separated list of fields to sort by, with optional direction (ASC/DESC). Example: `GenderId__c ASC,Occupation__c DESC` |
| timeGranularity | string | Time-based aggregation level. Available in API v53.0+. Values: `HOUR`, `DAY`, `MONTH`, `QUARTER`, `YEAR` |

The response includes:

*   `data`: Array of objects containing the requested dimensions and measures
*   `done`: Boolean indicating if all results have been returned

*   Use pagination (limit/offset) for retrieving large datasets
*   Time-based aggregation is only available in API version 53.0 and later
*   Filter values are case-sensitive
*   The orderby parameter supports multiple fields with different sort directions


---
<!-- cuppy -->
You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.
<!-- /cuppy -->