---
title: "A contest, survey or hunt as the public sees it"
method: GET
path: "/api/c/{slug}"
---

# A contest, survey or hunt as the public sees it

`GET /api/c/{slug}`

## Request

- Base URL: `https://qrvote.org`
- URL: `https://qrvote.org/api/c/{slug}`
- Auth: none declared

Entries (contests), questions (surveys) or checkpoints (hunts; unfound ones show only their clue). Entry QR codes are never included when scanning is required.

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `campaign` Campaign
    - `kind` 'contest' | 'survey' | 'hunt'
    - `quiz` boolean: Surveys: a quiz. Questions may have correct answers and each response gets a score. Correct answers are public only once the quiz closes.
    - `leaderboard` boolean: Quizzes: players may add a name and scores are ranked.
    - `hostSecs` integer: Live quizzes: seconds per question on the auto clock (0 = the organizer moves it on).
    - `host` boolean: Quizzes: run live by the organizer, one question at a time. The public sees only questions already asked and answers already revealed.
    - `slug` string
    - `title` string
    - `description` string
    - `mode` 'single' | 'each': Contests: pick one favorite, or like several.
    - `results` 'live' | 'after' | 'private'
    - `requireScan` boolean
    - `requireBallot` boolean
    - `allowChange` boolean
    - `categories` object[]: Contests: award categories. Each phone gets one vote in each. Empty = one overall vote.
      - `id` integer
      - `name` string
    - `judging` boolean: Contests: judges score the entries too. Their award is public once voting closes (unless results are private).
    - `opensAt` integer, nullable: Unix ms
    - `closesAt` integer, nullable: Unix ms
    - `status` 'scheduled' | 'open' | 'closed'
    - `resultsVisible` boolean

## Other responses

- `404`: Not found
- `410`: Removed by QRvote for breaking the rules

---

[API](https://skmtc.dev/qrvote/apis/qrvote-api.md) · [All operations](https://skmtc.dev/qrvote/apis/qrvote-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qrvote/apis/qrvote-api/revisions/4b67158991e0?raw)