---
title: "/:channel/:contestId"
method: GET
path: "/contests/{channel}/{contestId}"
tags: ["single contest", "contests"]
---

# /:channel/:contestId

`GET /contests/{channel}/{contestId}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/contests/{channel}/{contestId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/contests/:channel/:contestId/get.ts> (a function with typed inputs; its response is checked against the schema)

List contests

## Path parameters

- `channel` string, required
- `contestId` string, required

## Headers

- `Accept` string, required

## Response `200`

- Contest
  - `botResponses` boolean, required
  - `totalAmount` integer, required
  - `totalUsers` integer, required
  - `_id` string, required
  - `title` string, required
  - `minBet` integer, required
  - `maxBet` integer, required
  - `duration` integer, required
  - `options` Option[], required
    - `totalAmount` integer, required
    - `totalUsers` integer, required
    - `_id` string, required
    - `title` string, required
    - `command` string, required
  - `channel` string, required
  - `state` string, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `404`: Not Found

## Changes

- **2022-08-19** `7ec3cd3b664e`: 1 breaking, 3 info
  - the response's body type changed from no type to `object` for status `404`
  - added the required property `error` to the response with the `404` status
  - added the required property `message` to the response with the `404` status
  - added the required property `statusCode` to the response with the `404` status
- **2021-02-22** `51e3df32da57`: 13 info
  - added the required property `_id` to the response with the `200` status
  - added the required property `botResponses` to the response with the `200` status
  - added the required property `channel` to the response with the `200` status
  - added the required property `createdAt` to the response with the `200` status
  - …9 more
- **2021-02-08** `8421cd25897f`: 1 info
  - api tag `contests` added
- **2021-02-07** `8c745ed2e9e4`: 12 warning
  - the optional response header `Access-Control-Allow-Credentials` removed for the status `200`
  - the optional response header `Access-Control-Expose-Headers` removed for the status `200`
  - the optional response header `ETag` removed for the status `200`
  - the optional response header `Server` removed for the status `200`
  - …8 more

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/contests/:channel/:contestId/get.md)

---

[API](https://skmtc.dev/streamelements/apis/se-api-docs.md) - [All operations](https://skmtc.dev/streamelements/apis/se-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/streamelements/apis/se-api-docs/revisions/aa13169b9373?raw)