---
title: "Get a competition"
method: GET
path: "/v2/odds/competitions/{key}"
tags: ["API-Version-2.0"]
---

# Get a competition

`GET /v2/odds/competitions/{key}`

Shows live and upcoming events of the given competiiton key

## Path parameters

- `key` string, required

## Query parameters

- `from` integer
- `to` integer
- `markets` string[]
- `players` boolean
- `limit` integer

## Response `200`

CompetitionResponse

- CompetitionResponse — CompetitionResponse presents competition with list of events
  - `category` Identifier — Identifier represents a name-key tuple which together identify a given entity such as a sport
    - `key` string — slug for this Identifier
    - `name` string — name of this Identifier
  - `events` EventForCompetition[] — list of all events associated with this competition
    - `away` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
      - `abbreviation` string — abbreviation for this team's name
      - `key` string — slug for this Identifier
      - `name` string — name of this Identifier
      - `nationality` string — team country code
    - `cutoffTime` string — event cutoff time in string format "2006-01-02T15:04:05Z07:00" (RFC3339)
    - `home` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
      - `abbreviation` string — abbreviation for this team's name
      - `key` string — slug for this Identifier
      - `name` string — name of this Identifier
      - `nationality` string — team country code
    - `id` integer — unique ID for this Event
    - `key` string — slug for this Event
    - `markets` object — mapping between market key and all associated markets for this Event
    - `metadata` EventMetadata — Event metadata contains additional event info
      - `opinion` OutcomeProbability[] — (deprecated, use opinions instead) opinion is an answer to the question "How do players bet on Cloudbet v/s the currently offered odds?"
        - `marketKey` string — market key used to build opinion
        - `outcome` string — outcome
        - `params` string — market parameters used to build opinion, such as handicap, period etc.
        - `probability` number, float — probability
      - `opinions` object — opinions represent the betting patterns of players on different outcomes of different markets
    - `name` string — name of this Event
    - `sequence` integer — sequential update number for this Event
    - `status` 'PRE_TRADING' | 'TRADING' | 'TRADING_LIVE' | 'RESULTED' | 'INTERRUPTED' | 'AWAITING_RESULTS' | 'POST_TRADING' | 'CANCELLED' — EventStatus presents the current status for a given Event
  - `key` string — slug for this Competition. Composed of <sport-key>-<category-key>-<competition-key> as shown in the example value.
  - `name` string — name of this Competition
  - `sport` Identifier — Identifier represents a name-key tuple which together identify a given entity such as a sport
    - `key` string — slug for this Identifier
    - `name` string — name of this Identifier

## Other responses

- `400` — Error
- `401` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/cloudbet/apis/cloudbet-feed-api.md) · [All operations](https://skmtc.net/cloudbet/apis/cloudbet-feed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbet/cloudbet-feed-api/versions/304403f067b1/schema)