V3 REST Endpoints

V3 has no calendar hierarchy. There are no countries, categories, /categories/{id}/tournaments, /tournament/{id}/seasons, season info, rounds, knockout or paginated events/next|last routes — all of those return {"error":"Not found"}. Discovery is the rolling period windows (today, live, tomorrow, yesterday, all) only, and /all currently mirrors today (it echoes "period":"today"). Build your own tournament and round tree by polling the windows and grouping on league.leagueId, league.tournamentId and league.uniqueKey. Date-addressable and historical access live on V2 for the sports V2 covers.Search is football-only. /v3/{sport}/search?q=... returns football entities regardless of the sport slug or a sportId parameter, so it is not a discovery route for non-football 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. Only the ?q= form is valid — /search/{query} returns 404. It resolves a club from its name plus country and returns its logo in one call, which makes it a good complement to V6 search: V6 is the primary resolver and gives you the V6 entity id, while V3 hands back a ready-to-use logo URL with no key and covers some clubs V6 misses. Running both and keeping the first country-matching hit gives the best coverage:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v3/football/search?q=Emat"

{
  "query": "Emat",
  "results": [
    {
      "id": "vwMX58dg",
      "type": "participants",
      "participantType": "team",
      "title": "Emat (Chad)",
      "countryId": 50,
      "logo": "https://images.sportsapipro.com/res/image/data/t2ywBX83-juDYAHlS.png"
    }
  ]
}

Filter on participantType: "team"; the country is in title ("Name (Country)") and countryId.
logo is an absolute URL served from our image edge. It needs no API key, returns in well under a second and is cached for 180 days, so it is safe to store or hotlink.
Search is fuzzy: it always answers with its nearest match, so an unknown club can return a well-known one (q=Kono United returns Manchester Utd). Always reject a result whose country does not match the club you are resolving.
For bulk logo/ID backfills, use it alongside V6 search — V6 first for the entity id, V3 as a second pass for anything V6 returns empty for.

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 -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v3/football/live

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

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v3/football/search?q=manchester"

const response = await fetch(
  'https://api.sportsapipro.com/v3/football/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

// data.leagues is an array of { league, events }
console.log(`${data.totalEvents} events across ${data.totalLeagues} leagues`);

import requests

response = requests.get(
    'https://api.sportsapipro.com/v3/football/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"{data['totalEvents']} events across {data['totalLeagues']} leagues")

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Global Endpoints

Sports List

Match Counts

All Scores (Multi-Sport)

Search

Draw / Bracket

Sport Scores

Match Endpoints (string eventId)

Real Match Detail Response (Verified)

Team Endpoints (string teamId)

Example Requests

​Global Endpoints

​Sports List

​Match Counts

​All Scores (Multi-Sport)

​Search

​Draw / Bracket

​Sport Scores

​Match Endpoints (string eventId)

​Real Match Detail Response (Verified)

​Team Endpoints (string teamId)

​Example Requests

Global Endpoints

Sports List

Match Counts

All Scores (Multi-Sport)

Search

Draw / Bracket

Sport Scores

Match Endpoints (string eventId)

Real Match Detail Response (Verified)

Team Endpoints (string teamId)

Example Requests