---
schema_version: "1"
id: e379dee09c9d95f7963da6223a1bea1bcb1d8a57bb5766a222d6193ea3cb0efc
title: Query Calculated Insights
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-query-guide/references/data-cloud-query-api-reference/calculated-insights/c360a-api-ci-call-overview.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-ci-call-overview.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: ad171aa71b926cade25b9ea743c10d3357e0054c033811ce0de7eb5f74acc311
products:
  - Data 360 Query Guide
  - Data 360 Developer Documentation
---
# 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.

## Key Features

- **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

## API Limits

- Maximum return limit: 4,999 rows per query
- Pagination support via limit and offset parameters
- Comprehensive error handling with detailed response codes

## Metadata Endpoints

- [**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.md)

  - 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.md)
  - Retrieves metadata for a specific calculated insight
  - Returns detailed information about dimensions, measures, and relationships

## Query Endpoints

- [**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.md)
  - 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

## Additional Resources

- [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)