Skip to main content

Get public contest leaderboard (v1)

Method & Path​

GET /api/v1/public/contest/:token/leaderboard

Optional:

GET /api/v1/public/:workspaceSlug/contest/:token/leaderboard

Description​

Returns the finalized ranking after the host has ended the contest.

note

Per-row attemptId is not included on this public endpoint. The workspace dashboard GET .../contests/:contestId/leaderboard response includes attemptId for each row so owners can load per-attempt answer detail.

Authentication​

None.

Response 200 OK​

{
  "leaderboard": [
    {
      "rank": 1,
      "introResponses": {},
      "scoreCorrect": 10,
      "totalQuestions": 10,
      "durationSeconds": 60,
      "submittedAt": "2026-01-01T12:00:00.000Z"
    }
  ]
}

Common Errors​

  • 404 Not Found
  • 409 Conflict: Contest not ended yet
  • 500 Internal Server Error