API Reference

Developer API Documentation

Integrate OpenQuiz into your applications with our comprehensive REST API.

Getting Started

Use the origin of your OpenQuiz deployment
https://your-openquiz-host.example

Authentication

Protected account and host endpoints require the access token issued after sign-in. Public lobby lookup and registration have separate access rules. Include the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

API Endpoints

Authentication

Learn how to authenticate API requests

POST
/api/auth/login

User login

POST
/api/auth/send-registration-otp

Request a registration code when email delivery is configured

POST
/api/auth/register-with-otp

Register with a valid verification code

GET
/api/auth/profile

Get user profile

Quizzes

Manage quizzes programmatically

GET
/api/quizzes

List your quizzes

POST
/api/quizzes

Create a new quiz

GET
/api/quizzes/:id

Get quiz details

PUT
/api/quizzes/:id

Update quiz

DELETE
/api/quizzes/:id

Delete quiz

Games

Control and manage live games

POST
/api/games

Start a new game

GET
/api/games/:pin

Get game details

POST
/api/games/:pin/start

Start the game

POST
/api/games/:pin/end-question

Close the current question; expected_question_index is required

POST
/api/games/:pin/next

Advance once; expected_question_index is required

Need API Access?

API access is available for Pro and Enterprise plans. Contact us to get started.