List Sports

GET

sports

List Sports

curl --request GET \
  --url https://api.sportsapipro.com/v1/football/sports \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/sports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/sports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/sports"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/sports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "lastUpdateId": 5494749399,
  "requestedUpdateId": -1,
  "ttl": 600,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 2,
      "name": "Basketball",
      "nameForURL": "basketball",
      "imageVersion": 1
    },
    {
      "id": 3,
      "name": "Tennis",
      "nameForURL": "tennis",
      "imageVersion": 1
    },
    {
      "id": 4,
      "name": "Hockey",
      "nameForURL": "hockey",
      "imageVersion": 1
    },
    {
      "id": 5,
      "name": "Handball",
      "nameForURL": "handball",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 6,
      "name": "A. Football",
      "nameForURL": "a.-football",
      "imageVersion": 1
    },
    {
      "id": 7,
      "name": "Baseball",
      "nameForURL": "baseball",
      "imageVersion": 1
    },
    {
      "id": 8,
      "name": "Volleyball",
      "nameForURL": "volleyball",
      "imageVersion": 1
    },
    {
      "id": 9,
      "name": "Rugby",
      "nameForURL": "rugby",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 11,
      "name": "Cricket",
      "nameForURL": "cricket",
      "imageVersion": 1
    }
  ]
}

Overview

Returns a list of all available sports types supported by the API. This endpoint is useful for discovering which sports are available and their corresponding IDs for filtering other endpoints.

The API automatically determines user language, timezone, and country based on request context. You don’t need to specify default values for these parameters—they are resolved automatically.

Request

Query Parameters (Optional Overrides)

number

Application type identifier (auto-resolved)

number

Language identifier (auto-resolved, 1 = English)

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All date/time fields use ISO 8601 format with a dynamic timezone offset.

number

Country identifier for localization (auto-resolved)

Request Examples

curl -X GET "https://api.sportsapipro.com/v1/football/sports" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch('https://api.sportsapipro.com/v1/football/sports', {
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v1/football/sports',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

Response

{
  "lastUpdateId": 5494749399,
  "requestedUpdateId": -1,
  "ttl": 600,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 2,
      "name": "Basketball",
      "nameForURL": "basketball",
      "imageVersion": 1
    },
    {
      "id": 3,
      "name": "Tennis",
      "nameForURL": "tennis",
      "imageVersion": 1
    },
    {
      "id": 4,
      "name": "Hockey",
      "nameForURL": "hockey",
      "imageVersion": 1
    },
    {
      "id": 5,
      "name": "Handball",
      "nameForURL": "handball",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 6,
      "name": "A. Football",
      "nameForURL": "a.-football",
      "imageVersion": 1
    },
    {
      "id": 7,
      "name": "Baseball",
      "nameForURL": "baseball",
      "imageVersion": 1
    },
    {
      "id": 8,
      "name": "Volleyball",
      "nameForURL": "volleyball",
      "imageVersion": 1
    },
    {
      "id": 9,
      "name": "Rugby",
      "nameForURL": "rugby",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 11,
      "name": "Cricket",
      "nameForURL": "cricket",
      "imageVersion": 1
    }
  ]
}

Response Fields

Root Object

Field	Type	Description
`lastUpdateId`	number	Internal versioning ID for the data, used for caching or incremental updates
`requestedUpdateId`	number	The update ID requested by the client. `-1` means “retrieve the latest data”
`ttl`	number	Time To Live in seconds. Indicates how long the response can be cached (600 = 10 minutes)
`sports`	array	Array of available sport objects

Sport Object

Field	Type	Description
`id`	number	Unique identifier for the sport. Use this ID to filter other endpoints
`name`	string	Display name of the sport
`nameForURL`	string	URL-friendly slug for the sport
`drawSupport`	boolean	Whether the sport supports draw results (optional, present for sports like Football, Rugby)
`imageVersion`	number	Version number of the sport’s image asset

Sport IDs Reference

ID	Sport
1	Football (Soccer)
2	Basketball
3	Tennis
4	Hockey
5	Handball
6	American Football
7	Baseball
8	Volleyball
9	Rugby
11	Cricket
1000	TV (Where to Watch)

Use these sport IDs with other endpoints like /games/allscores?sports=1 to filter results by sport type. For example, sports=1 returns only Football matches.

Caching

This endpoint has a built-in TTL of 600 seconds (10 minutes). The data rarely changes, so you can safely cache the response on your end for extended periods.

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Response

200 - application/json

OK. Example recorded 24 October 2026 from GET /v1/football/sports (lists trimmed to 2).

Last modified on June 29, 2026

List Sports

curl --request GET \
  --url https://api.sportsapipro.com/v1/football/sports \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/sports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/sports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/sports"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/sports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "lastUpdateId": 5494749399,
  "requestedUpdateId": -1,
  "ttl": 600,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 2,
      "name": "Basketball",
      "nameForURL": "basketball",
      "imageVersion": 1
    },
    {
      "id": 3,
      "name": "Tennis",
      "nameForURL": "tennis",
      "imageVersion": 1
    },
    {
      "id": 4,
      "name": "Hockey",
      "nameForURL": "hockey",
      "imageVersion": 1
    },
    {
      "id": 5,
      "name": "Handball",
      "nameForURL": "handball",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 6,
      "name": "A. Football",
      "nameForURL": "a.-football",
      "imageVersion": 1
    },
    {
      "id": 7,
      "name": "Baseball",
      "nameForURL": "baseball",
      "imageVersion": 1
    },
    {
      "id": 8,
      "name": "Volleyball",
      "nameForURL": "volleyball",
      "imageVersion": 1
    },
    {
      "id": 9,
      "name": "Rugby",
      "nameForURL": "rugby",
      "drawSupport": true,
      "imageVersion": 1
    },
    {
      "id": 11,
      "name": "Cricket",
      "nameForURL": "cricket",
      "imageVersion": 1
    }
  ]
}

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Request

Query Parameters (Optional Overrides)

Request Examples

Response

Response Fields

Root Object

Sport Object

Sport IDs Reference

Caching

Authorizations

Response

​Overview

​Request

​Query Parameters (Optional Overrides)

​Request Examples

​Response

​Response Fields

​Root Object

​Sport Object

​Sport IDs Reference

​Caching

Authorizations

Response

Overview

Request

Query Parameters (Optional Overrides)

Request Examples

Response

Response Fields

Root Object

Sport Object

Sport IDs Reference

Caching