Current Games

GET

games

current

Live Games

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

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

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

	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/current")

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

{
  "games": [
    {
      "id": 123,
      "statusText": "<string>",
      "statusGroup": 123,
      "homeCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": 123,
        "imageUrl": "<string>"
      },
      "awayCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": 123,
        "imageUrl": "<string>"
      },
      "competition": {
        "id": 123,
        "name": "<string>",
        "country": {
          "id": 123,
          "name": "<string>"
        },
        "hasStandings": true,
        "hasBrackets": true
      },
      "startTime": "2023-11-07T05:31:56Z"
    }
  ],
  "lastUpdateId": 123
}

Overview

Returns all current and upcoming games for a specified team (competitor), including recent results, scheduled matches, venue information, and optional betting odds. Useful for building team fixture lists and schedules.

Query Parameters

string

required

Team/competitor ID to get fixtures for.

boolean

default:"true"

Include betting odds in response.

integer

default:"14"

Preferred bookmaker ID for odds data.

integer

Application type identifier. Auto-resolved.

integer

Language identifier. Auto-resolved.

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York).

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

integer

User’s country for localization. Auto-resolved.

Response Structure

integer

Current update ID for incremental fetching.

integer

The update ID that was requested (-1 for latest).

integer

Cache time-to-live in seconds.

object

Summary statistics (may be empty).

array

Array of game objects for the team.

Show Game Object

integer

Game identifier.

integer

Sport type ID.

integer

Competition identifier.

integer

Season number.

integer

Stage number.

integer

Round number (for league games).

string

Round display name.

string

Stage name (e.g., “Quarter Finals”).

string

Formatted competition name.

string

ISO 8601 formatted start time with timezone offset (based on auto-resolved or specified timezone).

integer

Game status (2=Scheduled, 3=Live, 4=Ended).

string

Status description.

boolean

Whether lineup data is available.

integer

Lineup availability (2=Probable, 3=Confirmed).

string

Lineup status description.

boolean

Whether betting teaser is available.

object

Betting odds when showOdds=true.

Show Odds Object

integer

Betting line identifier.

integer

Bookmaker ID.

object

Market type (1X2, etc.).

object

Bookmaker details with branding.

array

Betting options with current, old, and original rates.

integer

Winning option for concluded markets.

boolean

Whether market is settled.

object

Home team details with score and qualification status.

object

Away team details with score and qualification status.

object

Stadium/venue information.

Show Venue Object

integer

Venue identifier.

string

Venue name.

string

URL-friendly venue name.

boolean

Whether statistics are available.

boolean

Whether standings are available.

boolean

Whether bracket view is available.

boolean

Whether betting markets exist.

boolean

Whether player prop markets exist.

boolean

Whether news articles exist.

array

Competitions the team is playing in.

Show Competition Object

integer

Competition identifier.

string

Competition name.

integer

Total games in this competition.

integer

Currently live games.

boolean

Whether active games exist.

array

Country information with game counts.

array

All teams referenced in fixtures.

array

Sports definitions.

array

Bookmaker information.

Example Request

curl -X GET "https://api.sportsapipro.com/v1/football/games/current?competitors=110&showOdds=true" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "lastUpdateId": 5495132368,
  "requestedUpdateId": -1,
  "ttl": 300,
  "summary": {},
  "games": [
    {
      "id": 4609055,
      "sportId": 1,
      "competitionId": 9,
      "stageName": "Quarter Finals",
      "competitionDisplayName": "EFL Cup - Quarter Finals",
      "startTime": "2025-12-17T19:30:00+00:00",
      "statusGroup": 4,
      "statusText": "Ended",
      "hasLineups": true,
      "lineupsStatus": 3,
      "lineupsStatusText": "Lineups",
      "hasBetsTeaser": true,
      "odds": {
        "lineId": 1622846746,
        "bookmakerId": 14,
        "lineType": {
          "id": 1,
          "name": "Full Time Result",
          "shortName": "1X2"
        },
        "bookmaker": {
          "id": 14,
          "name": "Bet365",
          "color": "#007B5B"
        },
        "options": [
          {
            "num": 1,
            "name": "1",
            "rate": {"decimal": 1.62, "fractional": "5/8", "american": "-161"},
            "originalRate": {"decimal": 1.3, "fractional": "3/10", "american": "-333"},
            "trend": 2,
            "isWon": true
          },
          {
            "num": 2,
            "name": "X",
            "rate": {"decimal": 4.2, "fractional": "16/5", "american": "+320"}
          },
          {
            "num": 3,
            "name": "2",
            "rate": {"decimal": 5.0, "fractional": "4/1", "american": "+400"}
          }
        ],
        "outcomeOptionNum": 1,
        "isConcluded": true
      },
      "homeCompetitor": {
        "id": 110,
        "name": "Manchester City",
        "shortName": "Man City",
        "score": 2.0,
        "isQualified": true,
        "isWinner": true
      },
      "awayCompetitor": {
        "id": 63,
        "name": "Brentford",
        "score": 0.0,
        "isQualified": false,
        "isWinner": false
      },
      "venue": {
        "id": 3911,
        "name": "Etihad Stadium",
        "shortName": "etihad-stadium"
      },
      "hasStats": true,
      "hasBets": true,
      "hasPlayerBets": true,
      "hasNews": true
    },
    {
      "id": 4452715,
      "competitionDisplayName": "Premier League",
      "startTime": "2025-12-20T15:00:00+00:00",
      "statusGroup": 2,
      "statusText": "Scheduled",
      "lineupsStatus": 2,
      "lineupsStatusText": "Probable Lineups",
      "odds": {
        "options": [
          {
            "num": 1,
            "name": "1",
            "rate": {"decimal": 1.22},
            "oldRate": {"decimal": 1.18},
            "trend": 3
          }
        ]
      },
      "homeCompetitor": {
        "id": 110,
        "name": "Manchester City"
      },
      "awayCompetitor": {
        "id": 113,
        "name": "West Ham United"
      },
      "venue": {
        "id": 3911,
        "name": "Etihad Stadium"
      }
    }
  ],
  "competitions": [
    {
      "id": 7,
      "name": "Premier League",
      "totalGames": 5,
      "liveGames": 0,
      "hasActiveGames": true
    },
    {
      "id": 9,
      "name": "EFL Cup",
      "totalGames": 1,
      "liveGames": 0,
      "hasActiveGames": true
    }
  ],
  "countries": [...],
  "competitors": [...],
  "sports": [...],
  "bookmakers": [...]
}

Use Cases

Team Fixture List

Display all upcoming and recent matches for a team profile page.

Competition Breakdown

Use competitions array to group fixtures by competition with game counts.

Venue Information

Show stadium details for each fixture.

Odds Tracking

Track odds movement using rate, oldRate, and originalRate with trend indicator.

Lineup Availability

Use lineupsStatus to indicate whether confirmed or probable lineups are available.

Notes

Games are ordered by date
Includes both home and away fixtures for the specified team
The isQualified and toQualify fields are relevant for knockout competitions
Use competitions.totalGames and competitions.liveGames for summary statistics
Odds include oldRate for tracking recent changes alongside originalRate for opening odds

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

competitions

integer

Filter by competition ID (e.g., 132 for NBA)

Example:

132

lastUpdateId

integer

For efficient polling - returns only updates since this ID

Response

200 - application/json

Live games retrieved successfully

games

object[]

Show child attributes

lastUpdateId

integer

Use for subsequent polling requests

Last modified on June 29, 2026

Live Games

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

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

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

	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/current")

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

{
  "games": [
    {
      "id": 123,
      "statusText": "<string>",
      "statusGroup": 123,
      "homeCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": 123,
        "imageUrl": "<string>"
      },
      "awayCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": 123,
        "imageUrl": "<string>"
      },
      "competition": {
        "id": 123,
        "name": "<string>",
        "country": {
          "id": 123,
          "name": "<string>"
        },
        "hasStandings": true,
        "hasBrackets": true
      },
      "startTime": "2023-11-07T05:31:56Z"
    }
  ],
  "lastUpdateId": 123
}

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

Query Parameters

Response Structure

Example Request

Example Response

Use Cases

Team Fixture List

Competition Breakdown

Venue Information

Odds Tracking

Lineup Availability

Notes

Authorizations

Query Parameters

Response

​Overview

​Query Parameters

​Response Structure

​Example Request

​Example Response

​Use Cases

​Team Fixture List

​Competition Breakdown

​Venue Information

​Odds Tracking

​Lineup Availability

​Notes

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response Structure

Example Request

Example Response

Use Cases

Team Fixture List

Competition Breakdown

Venue Information

Odds Tracking

Lineup Availability

Notes