Surveys - Survey Overview Metrics

Endpoint

/o/surveys/survey/overview

Ⓔ Enterprise Only
This API is available exclusively in Countly Enterprise.

Overview

Returns summary metrics for one Survey widget (widget_id) or aggregated metrics for all Survey widgets.

Authentication

Authentication methods:

• API Key (parameter): api_key=YOUR_API_KEY
• Auth Token (parameter): auth_token=YOUR_AUTH_TOKEN
• Auth Token (header): countly-token: YOUR_AUTH_TOKEN

Permissions

• Surveys: Read permission.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or auth_token)	API key authentication
auth_token	String	Yes (or api_key)	Auth token authentication
app_id	String	Yes	App ID
widget_id	String	No	Widget-specific overview
status	Boolean/String	No	Status filter for aggregated overview
calculate_totals	Boolean/String	No	Includes totals-calculated for widget mode

Response

Success Response

{
  "_id": "67b9db56f67aab0012cd8899",
  "name": "Product Feedback",
  "responded": 120,
  "shown": 340,
  "status": true
}

Response Fields

Field	Type	Description
_id	String	Widget ID (single-widget mode)
responded	Number	Number of responses
shown	Number	Number of impressions
status	Boolean/Object	Widget status or status aggregate object

Error Responses

• HTTP 404 - Widget not found:

{
  "result": "Widget not found."
}

Behavior/Processing

• With widget_id, loads one widget, joins creator details from members, and returns the widget document.
• With calculate_totals, additionally calculates period totals for shown and responded from the Survey aggregate model and stores them in totals-calculated.
• Without widget_id, aggregates all matching Survey widgets for the app and optional status.
• Aggregated overview returns total widgets by status plus summed responded and shown counts.
• Survey aggregate overview removes NPS-only fields such as scores, nps, and valued.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.feedback_widgets	Endpoint data source	Stores endpoint-related records this endpoint reads or modifies.
countly.members	Member/account enrichment	Stores member profile fields (for example names/IDs) used to resolve actor metadata.

---

Examples

/o/surveys/survey/overview?api_key=YOUR_API_KEY&app_id=YOUR_APP_ID&widget_id=67b9db56f67aab0012cd8899

Related Endpoints

• Surveys - Survey Widgets
• Surveys - Survey Data

Ⓔ Enterprise

This feature is part of Countly Enterprise.

Get Access:

• Learn about Enterprise
• Contact Sales
• Compare Versions

Already a Customer? Use support portal if you have any questions.

---

Last Updated

2026-04-18