---
title: "List Eligible Questions"
method: GET
path: "/api/quiz/eligible"
tags: ["quiz"]
---

# List Eligible Questions

`GET /api/quiz/eligible`

Metadata for every question this user may still be asked, plus today's
persisted counts so a client with no local state can resume approximately.
Selection, ordering and difficulty adaptation happen on the client.

## Query parameters

- `lang` string, nullable
- `capability` integer
- `challenge_date` string, date, nullable

## Headers

- `x-user-id` string, nullable

## Response `200`

Successful Response

- EligibleQuizQuestionsResponse
  - `language` string, required
  - `questions` EligibleQuizQuestion[], required
    - `id` integer, required
    - `difficulty` 'easy' | 'medium' | 'hard', required
    - `first_time_friendly` boolean, nullable
    - `attempt_state` 'unseen' | 'retry', required
    - `attempts` integer
  - `today` QuizDailySummary, required
    - `answered` integer
    - `correct` integer
    - `initial_answered` integer
    - `initial_correct` integer
    - `continued_answered` integer
    - `continued_correct` integer
    - `claimed_checkpoints` string[]

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `43d0eb2328db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usecreed/apis/creed-api/changes/api/quiz/eligible/get.md)

---

[API](https://skmtc.dev/usecreed/apis/creed-api.md) · [All operations](https://skmtc.dev/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecreed/apis/creed-api/revisions/21f5c6ea721e?raw)