---
title: "Quiz stats"
method: GET
path: "/quizzes/{id}/stats"
tags: ["Responses"]
---

# Quiz stats

`GET /quizzes/{id}/stats`

## Request

- Base URL: `https://quizgen.dev/api/v1`
- URL: `https://quizgen.dev/api/v1/quizzes/{id}/stats`
- Auth: HTTP bearer

Funnel stats — use this to answer "how's my quiz doing?".

## Response `200`

Views, funnel, and outcome distribution.

- object
  - `views` integer, required
  - `started` integer, required
  - `finished` integer, required
  - `completion_rate` number, nullable, required: null when there are no responses yet.
  - `outcomes` object: Present when the quiz uses `outcomes`: bucket key → count.

## Other responses

- `401`: Missing or invalid API key.
- `404`: No such quiz (or not yours).

---

[API](https://skmtc.dev/quizgen/apis/quizgen-api.md) · [All operations](https://skmtc.dev/quizgen/apis/quizgen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quizgen/apis/quizgen-api/revisions/100cf9a83300?raw)
