Skip to main content
v1 docs

Core API

Quiz Lifecycle

Start, play, complete, and report quiz attempts for paid members.

Paid quizzes follow a start → complete pipeline with timing validation on submissions.

Private application endpoints are intentionally omitted from public documentation. Contact support for approved partner access.

// Minimum completion payload
{
  "date": "2026-06-05",
  "score": 8,
  "total": 10,
  "totalTimeSeconds": 240,
  "quizId": "daily-2026-06-05",
  "attemptToken": "<from /api/quiz/start>",
  "rows": [
    {
      "question": "…",
      "correctAnswer": "B",
      "userAnswer": "B",
      "correct": true,
      "timeSeconds": 22
    }
  ]
}
Completion times must be at least 2 seconds per question and under 2 hours total or the API rejects the submission.

Related in this guide