Exams API
Use the Exams API when you need a heavier-weight assessment than a quiz: larger question sets, section planning, difficulty shaping, and duration-aware output.
Choose exams when the assessment needs more deliberate structure
Choose quizzes when you want diagnostic or study-oriented checks. Choose exams when you need larger, more deliberate assessment structures with pacing, longer duration, and a clearer sense of section planning.
The backend already treats exam generation as its own orchestration path, which is why the public contract deserves its own route family rather than being framed as just "a bigger quiz."
The family stays simple even when the output is heavier
Use `/create` to generate the exam.
Persist the returned `id` for later retrieval.
Use `/list` to browse saved exams.
Use `/get` when your product needs one specific exam resource.
Shape time, structure, and difficulty deliberately
Time density
Use it when exam pacing matters as much as question content.
Section planning
Section count and topic organization matter more here than they do for lightweight quizzes.
Question mix
Use question mix when the exam needs a deliberate blend of multiple choice, true/false, and open-ended prompts.
Endpoints
/create
/api/v1/exams/create
Create a new exam with pacing, difficulty, and organizational controls. The response includes the encrypted public id plus the generated assessment structure.
/get
/api/v1/exams/get/{encrypted_id}
Fetch one exam by encrypted public id. Use this to rehydrate a stored exam in your application after the create flow has completed.
/list
/api/v1/exams/list
List the exams owned by the authenticated principal. This is the route to use for history views, dashboards, and external synchronization workflows.