Skip to main content
GET
/
games
/
current
Live Matches
curl --request GET \
  --url https://v1.tennis.sportsapipro.com/games/current \
  --header 'x-api-key: <api-key>'
{
  "games": [
    {
      "id": 123,
      "statusText": "<string>",
      "statusGroup": 123,
      "homeCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": "<string>",
        "imageUrl": "<string>"
      },
      "awayCompetitor": {
        "id": 123,
        "name": "<string>",
        "score": "<string>",
        "imageUrl": "<string>"
      },
      "competition": {
        "id": 123,
        "name": "<string>",
        "country": {
          "id": 123,
          "name": "<string>"
        },
        "hasStandings": true
      },
      "startTime": "2023-11-07T05:31:56Z"
    }
  ],
  "lastUpdateId": 123
}

​
Overview

Returns all tennis matches currently in progress with real-time scores. For Grand Slam and ATP/WTA events, data updates every ~5 seconds.

​
Code Examples

curl -X GET "https://v1.tennis.sportsapipro.com/games/current" \
  -H "x-api-key: YOUR_API_KEY"

​
Efficient Polling

Use lastUpdateId for efficient real-time updates: 
let lastUpdateId = null;

async function poll() {
  const url = lastUpdateId 
    ? `https://v1.tennis.sportsapipro.com/games/current?lastUpdateId=${lastUpdateId}`
    : 'https://v1.tennis.sportsapipro.com/games/current';
    
  const response = await fetch(url, {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  });
  const data = await response.json();
  lastUpdateId = data.lastUpdateId;
  
  // Only changed data is returned after first request
  return data.games;
}

setInterval(poll, 5000);

​
Response Structure

​
games
array
Array of live tennis matches
​
lastUpdateId
integer
Use for subsequent polling to get only changes
Filter by tournament using ?competitions=512 for Wimbledon matches only.

Authorizations

​
x-api-key
string
header
required

Your SportsAPI Pro API key

Query Parameters

​
competitions
integer

Filter by competition ID (e.g., 512 for Wimbledon)

Example:

512

​
lastUpdateId
integer

For efficient polling - returns only updates since this ID

Response

200 - application/json

Live matches retrieved successfully

​
games
object[]
​
lastUpdateId
integer

Use for subsequent polling requests