Skip to main content

Get public contest metadata (v1)

Method & Path​

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

Optional slug validation:

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

Description​

Returns contest name, workspace name, intro question definitions, branding, and status. Does not return correct answers.

Authentication​

None (public).

Response 200 OK​

{
  "contestName": "مسابقة",
  "workspaceName": "صالون النجوم",
  "publicStoreSlug": "my-store",
  "status": "open",
  "introQuestions": [{ "id": "f1", "label": "الاسم", "required": true }],
  "timeLimitSeconds": 300,
  "backgroundKind": "color",
  "backgroundColor": "#112233",
  "backgroundImageUrl": null
}

Common Errors​

  • 404 Not Found: Unknown token or slug mismatch
  • 500 Internal Server Error