--- cuppy_hub: salesforce cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-ci-call-overview.md cuppy_section: docs cuppy_doc: CR26-RHCC cuppy_doc_uuid: 600a4a6f-9ed6-41b1-b337-c66683a1cc6b cuppy_permalink: https://cuppy.io/salesforce/d/CR26-RHCC 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-ci-call-overview cuppy_mcp: https://cuppy.io/mcp cuppy_body_sha256: 0db41c388a0f8b648580b4a6e208909b7cc3bf93c1c1d1424b156929f3113ea1 # cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks. --- > Mirror of (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. ## Query Calculated Insights The Calculated Insights API provides a powerful way to query and analyze data from Data 360 Calculated Insights objects. This API allows you to retrieve metadata about available insights and query the insights with selected SQL dimensions and measures, including optional filters and time-based aggregations. * **Metadata Access**: Retrieve information about available calculated insights, including dimensions, measures, and relationships * **Flexible Querying**: Query insights with customizable dimensions, measures, and filters * **Pagination Support**: Handle large datasets with limit and offset parameters * **Time-based Analysis**: Aggregate data by different time granularities (HOUR, DAY, MONTH, QUARTER, YEAR) * **Sorting Capabilities**: Order results using multiple fields in ascending or descending order * Maximum return limit: 4,999 rows per query * Pagination support via limit and offset parameters * Comprehensive error handling with detailed response codes * [**GET /api/v1/insight/metadata**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-v1-insight-metadata.html) * Retrieves metadata for all available calculated insights * Returns dimensions, measures, and relationships for each insight * [**GET /api/v1/insight/metadata/{ci-name}**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-insights-meta-ci-name.html) * Retrieves metadata for a specific calculated insight * Returns detailed information about dimensions, measures, and relationships * [**GET /api/v1/insight/calculated-insights/{ci-name}**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-insights-ci-ci-name.html) * Query a specific calculated insight with customizable parameters * Supports filtering, sorting, pagination, and time-based aggregation * Returns actual data values based on specified dimensions and measures * [Calculated Insights Online Help](https://help.salesforce.com/s/articleView?id=data.c360_a_insights.htm&type=5) * [API Limits for Profile, Query, and Calculated Insights](https://help.salesforce.com/s/articleView?id=data.c360_a_limits_and_guidelines_cdp.htm&type=5) --- 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.