---
title: "Get aggregated survey results for visualization"
method: GET
path: "/cohorts/{cohortId}/feedback-surveys/results"
tags: ["Feedback Surveys"]
---

# Get aggregated survey results for visualization

`GET /cohorts/{cohortId}/feedback-surveys/results`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/feedback-surveys/results`
- Auth: HTTP bearer

Returns parsed and aggregated Paperform submission data grouped by section with response distributions for bar chart visualization

## Path parameters

- `cohortId` string, uuid, required

## Query parameters

- `form_type` 'session_feedback' | 'mid_program' | 'final_survey' | 'post_session' | 'midpoint' | 'endpoint', required
- `group_id` string, uuid
- `session_id` string, uuid

## Response `200`

Aggregated results retrieved

- object
  - `success` boolean
  - `data` object
    - `form_type` string
    - `survey_type` string
    - `total_submissions` integer
    - `total_participants` integer
    - `sections` object[]
      - `section_name` string
      - `questions` object[]
        - `question_id` string
        - `question_text` string
        - `question_type` string
        - `responses` object[]
          - `label` string
          - `count` integer
        - `total_responses` integer
        - `satisfaction_percentage` number, nullable

## Other responses

- `400`: Missing form_type query parameter
- `404`: Cohort not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)