---
title: "/surveys/:id/outcomes"
method: GET
path: "/surveys/{id}/outcomes"
---

# /surveys/:id/outcomes

`GET /surveys/{id}/outcomes`

## Request

- Base URL: `https://subdomain.workable.com/spi/v3`
- URL: `https://subdomain.workable.com/spi/v3/surveys/{id}/outcomes`
- Auth: API key in header `Authorization`

Returns aggregated results of a survey cycle: a response overview and per-question statistics. Required scope: `r_surveys`. Requires a user token whose member has permission to view survey cycles, or an account token with the `member_id` of such a member; an account token without `member_id` gets `403`. The account must have the Surveys feature enabled.

Only submitted responses of employees the member may view are aggregated. For anonymous surveys with `min_responses_required` > 0, the choice breakdown (`ratings[].count`, `percentage`, `average_score`) is withheld until the threshold is met overall and per question. `limit` / `offset` paginate questions; `total` is the number of matching questions.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `question_ids[]` string[]
- `member_id` string

## Response `200`

200

- object
  - `overview` object
    - `total_surveys` integer
    - `responses_count` integer
    - `average_response_time` number, nullable: Average completion time in seconds
    - `minimum_responses_requirement_met` boolean
  - `outcomes` object[]
    - `question_id` string
    - `question_type` 'paragraph' | 'paragraph_star_rated' | 'paragraph_numeric_rated' | 'paragraph_custom_rated' | 'single_choice' | 'multiple_choice' | 'star_rated' | 'numeric_rated' | 'custom_rated'
    - `question_title` string
    - `section_id` string
    - `section_title` string
    - `mandatory` boolean
    - `semantic_type` 'section_rating' | 'overall_rating'
    - `total_answers` integer
    - `average_score` number, nullable
    - `ratings` object[]
      - `value` string
      - `label` string
      - `count` integer
      - `percentage` number
    - `options` object: Rating options map, or `{ choices: {...} }` for choice questions. Omitted when none.
  - `total` integer

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404

## Changes

- **2026-11-03** `13ad2e8e2ee9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/workable/apis/account-root/changes/surveys/:id/outcomes/get.md)

---

[API](https://skmtc.dev/workable/apis/account-root.md) - [All operations](https://skmtc.dev/workable/apis/account-root/llms.txt) - [OpenAPI document](https://skmtc.dev/workable/apis/account-root/revisions/13ad2e8e2ee9?raw)