V3 REST Endpoints

Complete V3 API endpoint reference: scores, match details, teams, and search across 34 sports

Global Endpoints

Sports List

GET /api/v1/sports

Returns all 34 supported sports with IDs and slugs.

Match Counts

GET /api/v1/match-counts

Returns total and live event counts per sport.

All Scores (Multi-Sport)

GET /api/v1/scores

Returns today’s scores for all major sports in a single call.

Search

GET /api/v1/search?q={query}

Search for teams, players, and tournaments across all sports.

Draw / Bracket

GET /api/v1/draw/{sportId}/{tournamentId}

Returns draw/bracket data for cup or tennis tournaments.

---

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

Real Response (Verified):

{
  "sport": { "slug": "football", "id": 1, "name": "Football" },
  "period": "live",
  "totalEvents": 1731,
  "totalLeagues": 425,
  "leagues": [
    {
      "league": {
        "name": "ENGLAND: Premier League",
        "country": "England",
        "countryId": 198,
        "leagueId": "8ECkLGL5",
        "tournamentId": "EcZwBi3N",
        "uniqueKey": "1_EcZwBi3N",
        "url": "/football/england/premier-league/",
        "logo": "https://images.sportsapipro.com/res/image/data/...",
        "hasStandings": true
      },
      "events": [
        {
          "id": "l2TocbiL",
          "startTime": "2026-04-11T19:00:00.000Z",
          "startTimestamp": 1775934000,
          "statusCode": 3,
          "status": "finished",
          "round": null,
          "homeTeam": {
            "name": "Manchester City",
            "shortName": "Man City",
            "abbr": "MCI",
            "id": "Wtn9Stg0",
            "participantId": "CMn7Clai",
            "slug": "manchester-city",
            "image": "https://images.sportsapipro.com/res/image/data/...",
            "redCards": 0
          },
          "awayTeam": {
            "name": "Arsenal",
            "shortName": "Arsenal",
            "abbr": "ARS",
            "id": "ppjDR086",
            "participantId": "Me4oCiMn",
            "slug": "arsenal",
            "image": "https://images.sportsapipro.com/res/image/data/...",
            "redCards": 0
          },
          "homeScore": { "current": 2, "halfTime": 1, "period1": 1, "period2": 2 },
          "awayScore": { "current": 1, "halfTime": 0, "period1": 0, "period2": 1 },
          "currentPeriod": 1,
          "lastUpdate": 1775940975
        }
      ]
    }
  ]
}

Key differences from V1/V2:

• Responses are grouped by league (not flat arrays)
• Event IDs are strings (e.g., "l2TocbiL")
• Team objects include full image URLs (no proxy needed)
• League objects include logo, url, hasStandings
• Score objects include halfTime, period1, period2

---

Match Endpoints (string eventId)

All match endpoints use string-based event IDs.

Endpoint	Description
GET /api/v1/match/{eventId}	Match summary + incidents
GET /api/v1/match/{eventId}/summary	Match summary (alias)
GET /api/v1/match/{eventId}/statistics	Match stats (possession, shots, xG)
GET /api/v1/match/{eventId}/lineups	Formations + lineups
GET /api/v1/match/{eventId}/h2h	Head-to-head history
GET /api/v1/match/{eventId}/scores	Period-by-period scores
GET /api/v1/match/{eventId}/standings	League standings context
GET /api/v1/match/{eventId}/commentary	Text commentary
GET /api/v1/match/{eventId}/odds	Bookmaker odds
GET /api/v1/match/{eventId}/tournament-odds	Tournament outright odds
GET /api/v1/match/{eventId}/news	Match-related news
GET /api/v1/match/{eventId}/report	Post-match report
GET /api/v1/match/{eventId}/top-scorers	League top scorers
GET /api/v1/match/{eventId}/timeline	Match timeline
GET /api/v1/match/{eventId}/config	Available data tabs
GET /api/v1/match/{eventId}/checksums	Change detection hashes

Real Match Detail Response (Verified)

{
  "eventId": "l2TocbiL",
  "periods": [
    { "period": "3", "homeScore": 0, "awayScore": 0 }
  ],
  "matchInfo": {
    "CAP": "69 500"
  },
  "incidents": [
    {
      "id": "dM00VIZh",
      "type": "card",
      "minute": "51'",
      "side": "away",
      "player": "Khairi A.",
      "playerUrl": "/player/khairi-ayoub/WURowHOm/",
      "playerId": "WURowHOm",
      "description": "Yellow Card",
      "assist": null
    },
    {
      "id": "4rr1mBZA",
      "type": "goal",
      "minute": null,
      "side": "3",
      "player": "Hammoudan A.",
      "playerUrl": "/player/hamoudane-ahmed/t4dwg7K1/",
      "playerId": "t4dwg7K1",
      "description": "Goal",
      "assist": null
    }
  ]
}

V3 incident types use strings: "goal", "card", "substitution". The side field can be "home", "away", or a numeric string. Player IDs are strings (e.g., "WURowHOm").

---

Team Endpoints (string teamId)

Endpoint	Description
GET /api/v1/team/{teamId}/transfers?page=0	Team transfers with pagination
GET /api/v1/team/{teamId}/schedule	Team fixtures
GET /api/v1/team/{teamId}/news	Team news

---

Example Requests

cURL — Live Football

curl -H "x-api-key: YOUR_API_KEY" \
  https://v3.football.sportsapipro.com/api/v1/football/live