Skip to main content

Global Endpoints

Sports List

GET /api/v1/sports
Returns all 34 supported sports with IDs and slugs. Response:
{
  "sports": [
    { "id": 1, "slug": "football", "name": "Football" },
    { "id": 2, "slug": "tennis", "name": "Tennis" },
    { "id": 3, "slug": "basketball", "name": "Basketball" }
  ]
}

Match Counts

GET /api/v1/match-counts
Returns total and live event counts per sport. Response:
{
  "counts": [
    { "sportId": 1, "slug": "football", "total": 1466, "live": 42 },
    { "sportId": 2, "slug": "tennis", "total": 312, "live": 18 },
    { "sportId": 3, "slug": "basketball", "total": 204, "live": 8 }
  ]
}

All Scores (Multi-Sport)

GET /api/v1/scores
Returns today’s scores for all major sports in a single call. Response:
{
  "sports": [
    {
      "sport": { "id": 1, "slug": "football", "name": "Football" },
      "totalEvents": 1466,
      "totalLive": 42
    }
  ]
}
GET /api/v1/search?q={query}
Search for teams, players, and tournaments across all sports. Response:
{
  "query": "manchester",
  "results": [
    {
      "type": "team",
      "id": "Wtn9Stg0",
      "name": "Manchester City",
      "sportId": 1,
      "image": "https://img.sportsapipro.com/data/team/Wtn9Stg0.png"
    },
    {
      "type": "tournament",
      "id": "8ECkLGL5",
      "name": "Premier League",
      "sportId": 1
    }
  ]
}

Draw / Bracket

GET /api/v1/draw/{sportId}/{tournamentId}
Returns draw/bracket data for cup or tennis tournaments. Response:
{
  "sportId": 2,
  "tournamentId": "tR4kN2mP",
  "rounds": [
    {
      "name": "Final",
      "matches": [
        {
          "id": "xpzR5OKq",
          "homeTeam": { "name": "Player A", "id": "abc123" },
          "awayTeam": { "name": "Player B", "id": "def456" },
          "homeScore": 2,
          "awayScore": 1,
          "status": "finished"
        }
      ]
    }
  ]
}

Sport Scores

Replace {sport} with any of the 34 sport slugs.
GET /api/v1/{sport}/today        # Today's matches
GET /api/v1/{sport}/live         # Live matches only
GET /api/v1/{sport}/tomorrow     # Tomorrow's matches
GET /api/v1/{sport}/yesterday    # Yesterday's matches
GET /api/v1/{sport}/all          # All matches
Response:
{
  "sport": { "slug": "football", "id": 1, "name": "Football" },
  "period": "today",
  "totalEvents": 1466,
  "totalLeagues": 404,
  "leagues": [
    {
      "league": {
        "name": "ENGLAND: Premier League",
        "country": "England",
        "leagueId": "8ECkLGL5",
        "logo": "https://img.sportsapipro.com/data/league/8ECkLGL5.png",
        "hasStandings": true
      },
      "events": [
        {
          "id": "xpzR5OKq",
          "startTime": "2026-04-04T15:00:00.000Z",
          "statusCode": 2,
          "status": "live",
          "homeTeam": {
            "name": "Manchester City",
            "id": "Wtn9Stg0",
            "image": "https://img.sportsapipro.com/data/team/Wtn9Stg0.png"
          },
          "awayTeam": {
            "name": "Arsenal",
            "id": "ppjDR086",
            "image": "https://img.sportsapipro.com/data/team/ppjDR086.png"
          },
          "homeScore": { "current": 2, "halfTime": 1 },
          "awayScore": { "current": 1, "halfTime": 0 }
        }
      ]
    }
  ]
}