---
title: "Next question"
method: GET
path: "/v1/quizzes/{id}/next"
tags: ["Results"]
---

# Next question

`GET /v1/quizzes/{id}/next`

Retrieve the next question given a list of answers. If no answers are specified, it will return the first question. Use a `version_id` to retrieve the next question for a specific version of the quiz.

## Path parameters

- `id` string, required

## Query parameters

- `key` string, required
- `section` string
- `quiz_session_id` string
- `quiz_version_id` string
- `version_id` string
- `a` string[]

## Response `200`

OK - Everything worked as expected.

- NextQuestion
  - `next_question` union — Next question
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `option` Option[]
        - `value` string, required — Value of the option.
        - `attribute` object — Attribute expression of the option.
        - `images` Images
          - `primary_url` string — Primary source of the image.
          - `primary_alt` string — Alt text of the primary image.
          - `secondary_url` string — Secondary source of the image.
          - `secondary_alt` string — Alt text of the secondary image.
        - `option_key` string, uuid — Unique ID of the option
      - `type` 'multiple'
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `option` Option[]
        - `value` string, required — Value of the option.
        - `attribute` object — Attribute expression of the option.
        - `images` Images
          - `primary_url` string — Primary source of the image.
          - `primary_alt` string — Alt text of the primary image.
          - `secondary_url` string — Secondary source of the image.
          - `secondary_alt` string — Alt text of the secondary image.
        - `option_key` string, uuid — Unique ID of the option
      - `type` 'single'
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `type` 'open'
      - `input_placeholder` string, nullable
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `type` 'cover'
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `option` Option[]
        - `value` string, required — Value of the option.
        - `attribute` object — Attribute expression of the option.
        - `images` Images
          - `primary_url` string — Primary source of the image.
          - `primary_alt` string — Alt text of the primary image.
          - `secondary_url` string — Secondary source of the image.
          - `secondary_alt` string — Alt text of the secondary image.
        - `option_key` string, uuid — Unique ID of the option
      - `filter_name` string[]
      - `type` 'multiple_filter_values'
    - object
      - `id` number
      - `title` string
      - `description` string, nullable
      - `images` Images
        - `primary_url` string — Primary source of the image.
        - `primary_alt` string — Alt text of the primary image.
        - `secondary_url` string — Secondary source of the image.
        - `secondary_alt` string — Alt text of the secondary image.
      - `cta_text` string, nullable
      - `key` string
      - `is_skippable` boolean
      - `priority` number, nullable
      - `bucket_id` string, nullable
      - `option` Option[]
        - `value` string, required — Value of the option.
        - `attribute` object — Attribute expression of the option.
        - `images` Images
          - `primary_url` string — Primary source of the image.
          - `primary_alt` string — Alt text of the primary image.
          - `secondary_url` string — Secondary source of the image.
          - `secondary_alt` string — Alt text of the secondary image.
        - `option_key` string, uuid — Unique ID of the option
      - `filter_name` string[]
      - `type` 'single_filter_value'
  - `total_questions` number — Gives the total number of questions in the quiz
  - `version_id` string — Version id of this quiz
  - `quiz_version_id` string — Version id of this quiz
  - `quiz_id` string — id of quiz
  - `quiz_session_id` string — Session id of this quiz

## Other responses

- `400` — Bad Request - The request was unacceptable, often due to missing a required parameter.
- `404` — Not Found - The resource you are looking for cannot be found.
- `500` — Internal Server Error - Something went wrong on Constructor's end (these are rare).

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)