---
title: "Get quiz answers analytics data"
method: GET
path: "/reports/quiz-answers"
---

# Get quiz answers analytics data

`GET /reports/quiz-answers`

Retrieve user response analytics for a specific quiz showing distribution of answers across screens.
This endpoint returns data for creating charts showing how users answered each question in the quiz.

## Query parameters

- `project_id` integer, required
- `quiz_id` integer, required
- `from` string, date
- `to` string, date
- `filter_by_quiz_id` boolean
- `quiz_version` union
  - string — Comma-separated version numbers, e.g. "1,2,3"
  - integer[]
- `only_paying_users` boolean
- `answers_user_property` string
- `answers_user_property_value` string

## Headers

- `api_key` string, required

## Response `200`

Analytics data retrieved successfully

- object
  - `success` boolean
  - `data` object[]
    - `screen_id` string — Screen identifier
    - `screen_index` integer — Screen position in quiz
    - `screen_title` string — Screen title with ID
    - `total_responses` integer — Total number of responses for this screen
    - `chart_data` object — Chart.js compatible data structure
      - `labels` string[]
      - `datasets` object[]
        - `label` string
        - `data` integer[]
        - `backgroundColor` string[]
  - `quiz` object
    - `id` integer
    - `name` string
    - `screens_count` integer
  - `period` object
    - `from` string, date
    - `to` string, date
  - `filters` object — Echo of the filters applied to this request.
    - `filter_by_quiz_id` boolean
    - `quiz_version` integer[], nullable
    - `only_paying_users` boolean
    - `answers_user_property` string, nullable
    - `answers_user_property_value` string, nullable
  - `has_feature_answers_report` boolean — When false, `data` is limited to a free-tier preview (first 4 questions).

## Other responses

- `400` — Bad request - missing required parameters
- `403` — Forbidden - access denied to project or quiz
- `404` — Not found - project or quiz not found

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/versions/c88545119271/schema)