Endpoints

List Sports

GET/v1/sportsAPI key

Returns every supported sport, its key, availability and the regions where bookmakers are offered.

Request

cURL

curl https://api.openoddsapi.com/v1/sports \
  -H "X-API-Key: sk_test_your_key_here"

JavaScript

const res = await fetch("https://api.openoddsapi.com/v1/sports", {
  headers: { "X-API-Key": "sk_test_your_key_here" }
});
const sports = await res.json();
console.log(sports);

Python

import requests

res = requests.get(
    "https://api.openoddsapi.com/v1/sports",
    headers={"X-API-Key": "sk_test_your_key_here"},
)
sports = res.json()
print(sports)

200 OK — array of sport objects

JSON

[
  {
    "key": "tennis",
    "title": "Tennis",
    "group": "Racket",
    "description": "ATP and WTA — Grand Slams, Masters 1000, Tours and Challenger.",
    "active": true,
    "regions": ["us", "uk", "eu", "au"]
  },
  {
    "key": "ufc",
    "title": "UFC",
    "group": "MMA",
    "description": "UFC fight cards, bout by bout.",
    "active": true,
    "regions": ["us", "uk", "eu"]
  },
  {
    "key": "boxing",
    "title": "Boxing",
    "group": "Combat",
    "description": "Professional boxing bouts from the major promotions.",
    "active": true,
    "regions": ["us", "uk", "eu"]
  },
  {
    "key": "nfl",
    "title": "NFL",
    "group": "American Football",
    "description": "National Football League — regular season and playoffs.",
    "active": true,
    "regions": ["us", "uk", "eu"]
  },
  {
    "key": "golf",
    "title": "Golf",
    "group": "Tournament Golf",
    "description": "PGA Tour events, including majors and FedEx Cup playoffs.",
    "active": true,
    "regions": ["us", "uk", "eu", "au"]
  }
]

Fields

Field	Type	Description
key	string	Stable sport key used in all URLs.
title	string	Display name.
group	string	Sport group, e.g. Combat.
description	string	What the sport coverage includes.
active	boolean	Whether odds are currently live for the sport.
regions	string[]	Regions with bookmaker coverage.

NOTECheck active before building UI around a sport. Off-season sports are paused, not deleted.