Competitions

Get list of basketball competitions and leagues

GET /competitions

List Competitions

cURL

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

200

{
  "competitions": [
    {
      "id": 123,
      "name": "<string>",
      "country": {
        "id": 123,
        "name": "<string>"
      },
      "hasStandings": true,
      "hasBrackets": true
    }
  ]
}

V1 Legacy Endpoint — This is a V1 API endpoint. For new integrations, we recommend using the Basketball V2 API which provides richer data and more endpoints.

Overview

Returns a list of all basketball competitions (leagues, cups, tournaments) available in the API.

Query Parameters

countryId · integer

Filter by country ID (e.g., 65 for USA)

Code Examples

cURL

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

Response Structure

competitions · array

Array of competition objects

Show Competition Object

id · integer

Competition ID

name · string

Competition name

country · object

Country information (id, name)

imageUrl · string

Competition logo URL

hasStandings · boolean

Whether standings are available

hasBrackets · boolean

Whether playoff brackets are available

Key Competition IDs

Competition	ID	Country
NBA	132	USA
WNBA	2004	USA
NCAA Men’s	2065	USA
EuroLeague	138	Europe
EuroCup	139	Europe
Spanish ACB	149	Spain
Turkish BSL	150	Turkey
French Pro A	141	France
German BBL	142	Germany
Italian Lega Basket	143	Italy

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

countryId · integer

Filter by country ID

Response

200 - application/json

Competitions retrieved successfully

competitions · object[]

Show child attributes