---
title: "Get contests"
method: GET
path: "/v1/contests"
tags: ["Contests"]
---

# Get contests

`GET /v1/contests`

## Query parameters

- `active` boolean

## Response `200`

List of contests

- ApiContestInfoWithID[]
  - `id` integer, required
  - `info` ApiContestInfo, required
    - `title` string, required
    - `description` string, required
    - `references` ApiContentReference[], required
      - `ref_name` string, required
      - `ref_url` string, required
    - `conditions` ApiDexSwapCondition[], required
      - `type` 'unique' | 'listed' | 'partner_address' | 'tokens' | 'tokens-pair' | 'tokens-exact' | 'users-whitelist' | 'swap-tx-min-amount' | 'blacklist-pair' | 'blacklist-tokens' | 'dexes', required
      - `args` string[] — Arguments required to construct condition type
    - `rewards` ApiContestReward[], required
      - `reward` string, required
      - `place` integer
      - `place_from` integer
      - `place_to` integer
    - `start_time_unix` integer, required — in seconds
    - `end_time_unix` integer, required — in seconds
    - `image_url` string, required
    - `total_reward` string, required
    - `hidden` boolean, required

## Other responses

- `default` — Some error during request processing

---

[API](https://skmtc.net/swap/apis/swap-coffee-api.md) · [All operations](https://skmtc.net/swap/apis/swap-coffee-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swap/swap-coffee-api/revisions/fd1067547679/schema)