Competition 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 competition (league/tournament), use the fixtures endpoint with the competition ID. The response includes competition metadata in the competitions array along with upcoming matches.

Request

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

Parameters

Parameter	Type	Description
`competitions`	number	Competition 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 Examples

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

const response = await fetch(
  "https://api.sportsapipro.com/v1/football/games/fixtures?competitions=7685",
  {
    headers: { "x-api-key": "YOUR_API_KEY" }
  }
);
const data = await response.json();

// Find competition in the response
const competition = data.competitions?.find(c => c.id === 7685);

import requests

response = requests.get(
    "https://api.sportsapipro.com/v1/football/games/fixtures",
    params={"competitions": 7685},
    headers={"x-api-key": "YOUR_API_KEY"}
)
data = response.json()

# Find competition in the response
competition = next(
    (c for c in data.get("competitions", []) if c["id"] == 7685),
    None
)

Response

The competitions array in the response contains competition details:

{
  "competitions": [
    {
      "id": 7685,
      "countryId": 205,
      "sportId": 1,
      "name": "UEFA Conference League",
      "nameForURL": "uefa-conference-league",
      "hasBrackets": true,
      "hasStandings": true,
      "imageVersion": 1,
      "popularityRank": 150,
      "country": {
        "id": 205,
        "name": "Europe"
      }
    }
  ],
  "games": [
    // Array of upcoming fixtures
  ]
}

Competition Fields

Field	Type	Description
`id`	number	Unique competition identifier
`countryId`	number	ID of the country/region the competition belongs to
`sportId`	number	ID of the sport (1 = Football)
`name`	string	Full competition name
`nameForURL`	string	URL-friendly name for SEO
`hasBrackets`	boolean	Whether bracket/knockout stage data is available
`hasStandings`	boolean	Whether standings/table data is available
`imageVersion`	number	Version number for logo assets
`popularityRank`	number	Popularity score (lower = more popular)
`country`	object	Country information with id and name

SEO-Friendly URLs

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

/sports/competition/{nameForURL}-{id}

Example:

/sports/competition/uefa-conference-league-7685

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

Competition Standings - Get league table
Competition Fixtures - Get upcoming matches
Competition Results - Get past match results
Featured Competitions - Get popular leagues

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

Request

Parameters

Request Examples

Response

Competition Fields

SEO-Friendly URLs

Authorizations

Query Parameters

Response

​Overview

​Request

​Parameters

​Request Examples

​Response

​Competition Fields

​SEO-Friendly URLs

​Related Endpoints

Authorizations

Query Parameters

Response

Overview

Request

Parameters

Request Examples

Response

Competition Fields

SEO-Friendly URLs

Related Endpoints