Competitor Details

GET

games

fixtures

Upcoming Games

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/fixtures', 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/basketball/games/fixtures",
  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/basketball/games/fixtures"

	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/basketball/games/fixtures")

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

Overview

To fetch detailed information about a specific competitor (team/club), use the fixtures or results endpoints with the competitor ID. The /stats endpoint may return empty data for some competitors, so using fixtures/results endpoints is more reliable.

The /stats endpoint may return empty data for some competitors. Always use the fixtures or results endpoints as the primary source for competitor details, with stats as supplementary data.

Recommended Approach

Step 1: Fetch Competitor Data via Fixtures

GET https://api.sportsapipro.com/v1/football/games/fixtures?competitors={competitorId}

This returns upcoming matches for the competitor along with competitor metadata in the competitors array.

Step 2: Fallback to Results if No Fixtures

If the competitor has no upcoming fixtures, use the results endpoint:

GET https://api.sportsapipro.com/v1/football/games/results?competitors={competitorId}

Parameters

Parameter	Type	Description
`competitors`	number	Competitor ID to fetch details for
`showOdds`	boolean	Include betting odds (optional)
`timezoneName`	string	Timezone for date/time values (auto-resolved, or specify e.g., `America/New_York`)

All startTime fields in game data use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

Request

curl -X GET "https://api.sportsapipro.com/v1/football/games/fixtures?competitors=2112" \
  -H "x-api-key: YOUR_API_KEY"

// First try fixtures
const fixturesResponse = await fetch(
  "https://api.sportsapipro.com/v1/football/games/fixtures?competitors=2112",
  {
    headers: { "x-api-key": "YOUR_API_KEY" }
  }
);
const fixturesData = await fixturesResponse.json();

// Find competitor in the response
let competitor = fixturesData.competitors?.find(c => c.id === 2112);

// If not found in fixtures, try results
if (!competitor) {
  const resultsResponse = await fetch(
    "https://api.sportsapipro.com/v1/football/games/results?competitors=2112",
    {
      headers: { "x-api-key": "YOUR_API_KEY" }
    }
  );
  const resultsData = await resultsResponse.json();
  competitor = resultsData.competitors?.find(c => c.id === 2112);
}

import requests

# First try fixtures
fixtures_response = requests.get(
    "https://api.sportsapipro.com/v1/football/games/fixtures",
    params={"competitors": 2112},
    headers={"x-api-key": "YOUR_API_KEY"}
)
fixtures_data = fixtures_response.json()

# Find competitor in the response
competitor = next(
    (c for c in fixtures_data.get("competitors", []) if c["id"] == 2112),
    None
)

# If not found in fixtures, try results
if not competitor:
    results_response = requests.get(
        "https://api.sportsapipro.com/v1/football/games/results",
        params={"competitors": 2112},
        headers={"x-api-key": "YOUR_API_KEY"}
    )
    results_data = results_response.json()
    competitor = next(
        (c for c in results_data.get("competitors", []) if c["id"] == 2112),
        None
    )

Response

The competitors array in the response contains competitor details:

{
  "competitors": [
    {
      "id": 2112,
      "countryId": 190,
      "sportId": 1,
      "name": "Slovan Bratislava",
      "longName": "ŠK Slovan Bratislava",
      "shortName": "Sl. Bratislava",
      "symbolicName": "SLO",
      "nameForURL": "slovan-bratislava",
      "type": 1,
      "popularityRank": 8234,
      "imageVersion": 2,
      "color": "#0066CC",
      "awayColor": "#FFFFFF",
      "mainCompetitionId": 128,
      "hasSquad": true,
      "hasTransfers": false
    }
  ],
  "games": [
    // Array of upcoming fixtures
  ]
}

Important Notes

Always filter by ID: The competitors array may contain additional related teams (opponents). Always filter by the specific competitor ID you’re looking for.
Use fixtures first: Fixtures endpoint is preferred as it includes upcoming matches. Fall back to results if no fixtures are available.
Country lookup: Use the countryId to look up the country name from the /countries endpoint or the countries array in the response.

Competitor Fields

Field	Type	Description
`id`	number	Unique competitor identifier
`countryId`	number	ID of the country the competitor belongs to
`sportId`	number	ID of the sport (1 = Football)
`name`	string	Full competitor name
`longName`	string	Extended official name
`shortName`	string	Abbreviated display name
`symbolicName`	string	3-letter code (e.g., “SLO”, “BAR”)
`nameForURL`	string	URL-friendly name for SEO
`type`	number	Competitor type (1 = club, 2 = national team)
`popularityRank`	number	Popularity score (higher = more popular)
`imageVersion`	number	Version number for logo assets
`color`	string	Primary brand color in hex format
`awayColor`	string	Away kit/secondary color in hex format
`mainCompetitionId`	number	Primary competition ID
`hasSquad`	boolean	Whether squad data is available
`hasTransfers`	boolean	Whether transfer data is available

SEO-Friendly URLs

For SEO purposes, use the nameForURL field to construct URLs:

/sports/competitor/{nameForURL}-{id}

Example:

/sports/competitor/slovan-bratislava-2112

The route extracts the ID from the last segment of the slug (after the final hyphen) to fetch the competitor data.

Competitor Fixtures - Get upcoming matches
Competitor Results - Get past match results
Competitor Squad - Get team roster
Top Competitors - Get popular teams

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

competitions

integer

Filter by competition ID

Example:

132

date

string<date>

Filter by date (YYYY-MM-DD)

Example:

"2026-01-26"

Response

200

Fixtures retrieved successfully

Last modified on June 29, 2026

Upcoming Games

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/fixtures', 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/basketball/games/fixtures",
  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/basketball/games/fixtures"

	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/basketball/games/fixtures")

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

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

Recommended Approach

Step 1: Fetch Competitor Data via Fixtures

Step 2: Fallback to Results if No Fixtures

Parameters

Request

Response

Important Notes

Competitor Fields

SEO-Friendly URLs

Authorizations

Query Parameters

Response

​Overview

​Recommended Approach

​Step 1: Fetch Competitor Data via Fixtures

​Step 2: Fallback to Results if No Fixtures

​Parameters

​Request

​Response

​Important Notes

​Competitor Fields

​SEO-Friendly URLs

​Related Endpoints

Authorizations

Query Parameters

Response

Overview

Recommended Approach

Step 1: Fetch Competitor Data via Fixtures

Step 2: Fallback to Results if No Fixtures

Parameters

Request

Response

Important Notes

Competitor Fields

SEO-Friendly URLs

Related Endpoints