Skip to main content
GET
/
games
/
current
Live Games
curl --request GET \
  --url https://v1.basketball.sportsapipro.com/games/current \
  --header 'x-api-key: <api-key>'
{
  "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

​
competitors
string
required
Team/competitor ID to get fixtures for.
​
showOdds
boolean
default:"true"
Include betting odds in response.
​
topBookmaker
integer
default:"14"
Preferred bookmaker ID for odds data.
​
appTypeId
integer
Application type identifier. Auto-resolved by upstream.
​
langId
integer
Language identifier. Auto-resolved by upstream.
​
timezoneName
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.
​
userCountryId
integer
User’s country for localization. Auto-resolved by upstream.

​
Response Structure

​
lastUpdateId
integer
Current update ID for incremental fetching.
​
requestedUpdateId
integer
The update ID that was requested (-1 for latest).
​
ttl
integer
Cache time-to-live in seconds.
​
summary
object
Summary statistics (may be empty).
​
games
array
Array of game objects for the team.
​
competitions
array
Competitions the team is playing in.
​
countries
array
Country information with game counts.
​
competitors
array
All teams referenced in fixtures.
​
sports
array
Sports definitions.
​
bookmakers
array
Bookmaker information.

​
Example Request

curl -X GET "https://v1.football.sportsapipro.com/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[]
​
lastUpdateId
integer

Use for subsequent polling requests