---
updatedAt: 2026-10-06T07:22:14.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/odds/llms.txt
---

# Sport Competitions

Returns a list of competitions for a sport ID that have odds available.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  **TTL / Cache:** 5 minutes

  **Data Updates:** As competitions gain or lose odds coverage

  Polling cadence for this and every other feed: [Update Frequencies](https://developer.sportradar.com/odds/docs/oc-ig-update-frequencies)
</Callout>

> 📘 Tracking Futures Odds
>
> Learn how to use the Sport Competitions feed and its `futures` flag to confirm coverage before pulling futures in our [Tracking Futures Odds](https://developer.sportradar.com/odds/docs/oc-ig-tracking-futures) integration scenario.

***

## Data Points

<Accordion title="Sport & Category" icon="fa-light fa-chart-simple-horizontal">
  | Attribute      | Parent Element             | Type   | Description                                                                            |
  | -------------- | -------------------------- | ------ | -------------------------------------------------------------------------------------- |
  | `country_code` | `competition` - `category` | String | Country code of a competition's category<br /><br />ex. `ENG`                          |
  | `id`           | `competition` - `category` | GUID   | Unique ID of a competition's category<br /><br />ex. `sr:category:1` (England, Soccer) |
  | `name`         | `competition` - `category` | String | Name of a competition's category<br /><br />ex. `England`                              |
</Accordion>

<Accordion title="Competition" icon="fa-light fa-chart-simple-horizontal">
  | Attribute      | Parent Element | Type    | Description                                                                     |
  | -------------- | -------------- | ------- | ------------------------------------------------------------------------------- |
  | `futures`      | `competition`  | Boolean | Signifies futures are available for a competition when `true`                   |
  | `gender`       | `competition`  | String  | Gender for a competition<br /><br />`men`, `women`                              |
  | `id`           | `competition`  | String  | Unique ID for a competition<br /><br />ex. `sr:competition:17` (Premier League) |
  | `markets`      | `competition`  | Boolean | Signifies prematch markets are available for a competition when `true`          |
  | `name`         | `competition`  | String  | Name of a competition<br /><br />ex. `Pro A`, `NBA`                             |
  | `player_props` | `competition`  | Boolean | Signifies player props are available for a competition when `true`              |
</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "odds-comparison-futures",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/oddscomparison-futures/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v2/{language_code}/sports/{sport_id}/competitions.{format}": {
      "get": {
        "summary": "Sport Competitions",
        "description": "Returns a list of competitions for a sport ID that have odds available.",
        "operationId": "oc-futures-sport-competitions",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2-letter code for supported languages<br><br>`en` (English)<br><br>English is the only fully supported language for this API. Click <span style=\"text-decoration:underline\">[here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx)</span> for valid language codes and a tabular list of available languages per competition.",
            "schema": {
              "type": "string",
              "default": "en"
            },
            "required": true
          },
          {
            "name": "sport_id",
            "in": "path",
            "description": "Unique Id of a sport<br><br>**Examples**: `sr:sport:1` (Soccer) or `sr:sport:2` (Basketball)<br><br>Find the complete list of available sports in the <span style=\"text-decoration:underline\">[Sports](https://developer.sportradar.com/odds/reference/oc-futures-sports)</span> endpoint",
            "schema": {
              "type": "string",
              "default": "sr:sport:2"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json`, `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"competitions\": [\n    {\n      \"category\": {\n        \"country_code\": \"string\",\n        \"id\": \"string\",\n        \"name\": \"string\"\n      },\n      \"futures\": true,\n      \"gender\": \"string\",\n      \"id\": \"string\",\n      \"markets\": true,\n      \"name\": \"string\",\n      \"player_props\": true\n    }\n  ],\n  \"generated_at\": \"2023-05-10T19:03:18.970Z\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "competitions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "category": {
                            "type": "object",
                            "properties": {
                              "country_code": {
                                "type": "string",
                                "example": "string"
                              },
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          },
                          "futures": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "gender": {
                            "type": "string",
                            "example": "string"
                          },
                          "id": {
                            "type": "string",
                            "example": "string"
                          },
                          "markets": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "name": {
                            "type": "string",
                            "example": "string"
                          },
                          "player_props": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          }
                        }
                      }
                    },
                    "generated_at": {
                      "type": "string",
                      "example": "2023-05-10T19:03:18.970Z"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```