List Sports

Retrieve all available sports types supported by the API

GET /sports

List Sports

cURL

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

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
    }
  ]
}

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 upstream service 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)

appTypeId · number

Application type identifier (auto-resolved)

langId · number

Language identifier (auto-resolved, 1 = English)

timezoneName · 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.

userCountryId · number

Country identifier for localization (auto-resolved)

Request Examples

cURL

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

Response

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

Sports list retrieved successfully