Match / Game Endpoints - SportsAPI Pro

Game Details

GET /api/match/:matchId

Full game details: teams, score, status, innings. Example: GET /api/match/15323741 (Braves vs Rays)

Inning-by-Inning Scores

GET /api/match/:matchId/scores

Score breakdown: 1st through 9th inning + extras.

Lineups / Batting Order

GET /api/match/:matchId/lineups

Starting batting order and starting pitcher. Pre-game vs confirmed. The response carries a data.confirmed boolean:

`data.confirmed`	Payload
`false`	The card has not been posted yet. `data.home.players` / `data.away.players` contain only what the league has announced so far — typically just the probable starting pitcher (0–1 entries).
`true`	Full card: batting order, pitchers and substitutes (`substitute: true`), each with `position`, `jerseyNumber`, player metadata and per-player batting/pitching statistics. `data.home.supportStaff` carries manager/coaching entries.

Treat success: true as “request OK” and data.confirmed === true as “lineup usable”. Recommended cadence: poll every 5 minutes from about 3 hours before first pitch and stop as soon as confirmed flips to true. Lineups are published when received from the upstream feed; SportsAPI Pro does not currently offer a fixed publication-delay SLA.

Coverage: confirmed lineups are available for MLB. KBO and CPBL return an upstream 404 for /lineups (schedules, scores and odds are unaffected). NPB is not currently carried in the baseball feed.V6 baseball does not expose /lineups at all — it returns 501. Use this V2 endpoint for baseball lineups.

Confirmed MLB lineup example

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/baseball/match/15506978/lineups"

Validate the response structure rather than assuming every successful request contains a complete card:

{
  "success": true,
  "data": {
    "confirmed": true,
    "home": {
      "players": [
        {
          "player": { "id": 12345, "name": "Player name" },
          "position": "CF",
          "jerseyNumber": "7",
          "substitute": false
        }
      ]
    },
    "away": {
      "players": []
    }
  }
}

The player values above are illustrative; the response shape and data.confirmed check are authoritative. Starting pitchers are included in the team player arrays with their position, while bench players use substitute: true when supplied.

Game Statistics

GET /api/match/:matchId/statistics

Team stats: hits, runs, errors, batting average, ERA.

Incidents / Play-by-Play

GET /api/match/:matchId/incidents

Runs scored, home runs, pitching changes, double plays.

Player Statistics

GET /api/match/:matchId/player-statistics

All player stats for the game.

Individual Player Stats

GET /api/match/:matchId/player/:pid/statistics

Best Players

GET /api/match/:matchId/best-players

Top performers / game ratings.

Game MVP / Award

GET /api/match/:matchId/award

Head to Head

GET /api/match/:matchId/h2h

Scoring Graph

GET /api/match/:matchId/graph

Scoring progression across innings.

Pre-Game Form

GET /api/match/:matchId/pregame-form

Streaks

GET /api/match/:matchId/streaks

Win/loss streaks for both teams.

Highlights

GET /api/match/:matchId/highlights

Media

GET /api/match/:matchId/media

Managers

GET /api/match/:matchId/managers

Fan Votes

GET /api/match/:matchId/votes

Ballpark / Venue

GET /api/match/:matchId/venue

Umpire Info

GET /api/match/:matchId/referee

TV Broadcast

GET /api/match/:matchId/channels

Featured Odds

GET /api/match/:matchId/odds

All Odds

GET /api/match/:matchId/odds/all

Pre-Game Odds

GET /api/match/:matchId/odds/pre-match

Live Odds

GET /api/match/:matchId/odds/live

Win Probability

GET /api/match/:matchId/winning-odds

Predicted Lineups

GET /api/match/:matchId/predicted-lineups

Injured List / Missing Players

GET /api/match/:matchId/missing-players

​Game Details

​Inning-by-Inning Scores

​Lineups / Batting Order

​Confirmed MLB lineup example

​Game Statistics

​Incidents / Play-by-Play

​Player Statistics

​Individual Player Stats

​Best Players

​Game MVP / Award

​Head to Head

​Scoring Graph

​Pre-Game Form

​Streaks

​Highlights

​Media

​Managers

​Fan Votes

​Ballpark / Venue

​Umpire Info

​TV Broadcast

​Featured Odds

​All Odds

​Pre-Game Odds

​Live Odds

​Win Probability

​Predicted Lineups

​Injured List / Missing Players

Game Details

Inning-by-Inning Scores

Lineups / Batting Order

Confirmed MLB lineup example

Game Statistics

Incidents / Play-by-Play

Player Statistics

Individual Player Stats

Best Players

Game MVP / Award

Head to Head

Scoring Graph

Pre-Game Form

Streaks

Highlights

Media

Managers

Fan Votes

Ballpark / Venue

Umpire Info

TV Broadcast

Featured Odds

All Odds

Pre-Game Odds

Live Odds

Win Probability

Predicted Lineups

Injured List / Missing Players