Skip to main content

​
Base URL

https://v2.tennis.sportsapipro.com

​
Live & Schedule (6 endpoints)

​
Live Matches

GET /api/live
Returns all currently live tennis matches with full match data — set scores, current game point, serve indicator, surface type, and player rankings. 
{
  "events": [
    {
      "id": 15987654,
      "homeTeam": {
        "id": 418794,
        "name": "Matisse Bobichon",
        "shortName": "M. Bobichon",
        "slug": "bobichon-matisse",
        "ranking": 711,
        "country": { "alpha2": "FR", "name": "France" },
        "sport": { "id": 5, "name": "Tennis", "slug": "tennis" },
        "type": 1
      },
      "awayTeam": {
        "id": 230306,
        "name": "Kasidit Samrej",
        "shortName": "K. Samrej",
        "ranking": 419,
        "country": { "alpha2": "TH", "name": "Thailand" }
      },
      "homeScore": {
        "current": 0,
        "display": 0,
        "period1": 2,
        "point": "15"
      },
      "awayScore": {
        "current": 0,
        "display": 0,
        "period1": 1,
        "point": "0"
      },
      "firstToServe": 2,
      "groundType": "Hardcourt outdoor",
      "status": { "code": 8, "type": "inprogress", "description": "1st set" },
      "tournament": { "name": "Challenger Tour", "slug": "challenger", "uniqueTournament": { "id": 2519 } },
      "startTimestamp": 1775959066
    }
  ]
}
Tennis-specific fields in live data:
  • point — current game point as a string ("0", "15", "30", "40", "AD")
  • firstToServe — 1 = home player serving, 2 = away player serving
  • groundType — surface type ("Hardcourt outdoor", "Hardcourt indoor", "Clay", "Grass")
  • ranking — current ATP/WTA ranking (on each team/player object)
  • period1 through period5 — games won per set (dynamic — only appears once set starts)
  • period1TieBreak — tiebreak score (only appears during/after a tiebreak)

​
Live (All)

GET /api/live/all
Returns all live data (raw, unfiltered).

​
Today’s Games

GET /api/today
Returns today’s scheduled tennis matches.

​
Schedule by Date

GET /api/schedule/{date}
​
date
string
required
Date in YYYY-MM-DD format.

​
Live Tournaments

GET /api/live-tournaments
Returns tournaments with live matches right now.

​
Newly Added Events

GET /api/newly-added-events
Returns recently added events.

​
Search & Discovery (5 endpoints)

GET /api/search?q={query}
Search for players, tournaments, and teams.
​
q
string
required
Search query (e.g., alcaraz, wimbledon).

​
Countries / Categories

GET /api/countries
Returns tennis categories/countries.

​
Countries (All)

GET /api/countries/all
Returns extended categories list.

​
Category Tournaments

GET /api/categories/{categoryId}/tournaments
Returns tournaments in a specific category/country.

​
Country Flag

GET /api/country/{code}/flag
Returns the country flag image URLs (PNG and SVG).

​
Example Requests

# Live tennis matches
curl -X GET "https://v2.tennis.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

# Search for a player
curl -X GET "https://v2.tennis.sportsapipro.com/api/search?q=djokovic" \
  -H "x-api-key: YOUR_API_KEY"

# Country flag
curl -X GET "https://v2.tennis.sportsapipro.com/api/country/US/flag" \
  -H "x-api-key: YOUR_API_KEY"
# Returns: { "flagUrl": "https://flagcdn.com/w80/us.png", "flagSvg": "https://flagcdn.com/us.svg" }
Last modified on April 12, 2026