---
title: "Start a season quiz"
method: POST
path: "/api/quiz/season/start"
tags: ["Quiz"]
---

# Start a season quiz

`POST /api/quiz/season/start`

## Request

- Base URL: `https://api.chipprofessionals.com`
- URL: `https://api.chipprofessionals.com/api/quiz/season/start`
- Auth: none declared

## Response `201`

Quiz started

- QuizSeasonStartSuccess
  - `success` true, required
  - `data` QuizSeasonStartData, required
    - `session_id` string, uuid, required
    - `current_question` QuizSeasonQuestion, required
      - `slug` string, required
      - `signal` string, nullable, required
      - `prompt` string, required
      - `options` QuizQuestionOption[], required
        - `key` string, nullable, required
        - `label` string, nullable, required
    - `total_questions` integer, required
    - `answered_question_slugs` string[], required
    - `is_complete` boolean, required
    - `season_metadata` object
  - `message` string, required

## Other responses

- `403`: Guest credential or origin rejected
- `422`: No active questions
- `429`: Rate limited: 30 requests per minute per IP
- `500`: Server error

---

[API](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation.md) - [All operations](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/revisions/05e58f424c25?raw)