Live, Schedule & Search Endpoints

14 endpoints for live baseball games, schedules, search, and discovery

Base URL

https://v2.baseball.sportsapipro.com

---

Live & Schedule (7 endpoints)

Live Games

GET /api/live

Returns all currently live baseball games with inning-by-inning scores, R-H-E totals, and game status.

Example Response — /api/live

{
  "success": true,
  "count": 6,
  "events": [
    {
      "id": 15507547,
      "homeTeam": { "id": 3656, "name": "Atlanta Braves" },
      "awayTeam": { "id": 3650, "name": "Cleveland Guardians" },
      "homeScore": {
        "current": 0,
        "display": 0,
        "period1": 0, "period2": 0, "period3": 0, "period4": 0,
        "period5": 0, "period6": 0, "period7": 0, "period8": 0, "period9": 0,
        "innings": {
          "inning1": { "run": 0 }, "inning2": { "run": 0 }, "inning3": { "run": 0 },
          "inning4": { "run": 0 }, "inning5": { "run": 0 }, "inning6": { "run": 0 },
          "inning7": { "run": 0 }, "inning8": { "run": 0 }, "inning9": { "run": 0 }
        },
        "inningsBaseball": { "hits": 5, "errors": 1, "run": 0 }
      },
      "awayScore": {
        "current": 6,
        "display": 6,
        "period1": 1, "period2": 0, "period3": 0, "period4": 0,
        "period5": 0, "period6": 1, "period7": 0, "period8": 1, "period9": 3,
        "innings": {
          "inning1": { "run": 1 }, "inning2": { "run": 0 }, "inning3": { "run": 0 },
          "inning4": { "run": 0 }, "inning5": { "run": 0 }, "inning6": { "run": 1 },
          "inning7": { "run": 0 }, "inning8": { "run": 1 }, "inning9": { "run": 3 }
        },
        "inningsBaseball": { "hits": 7, "errors": 0, "run": 6 }
      },
      "status": { "code": 29, "description": "9th Inning", "type": "inprogress" },
      "tournament": "MLB",
      "tournamentId": 11205,
      "season": "MLB 2026",
      "seasonId": 84695,
      "roundInfo": { "round": 1 },
      "startTimestamp": 1775949300
    }
  ],
  "timezone": { "name": "UTC", "source": "default", "utcOffset": "+00:00" }
}

Baseball-specific score fields:

• period1–period9 — runs scored per inning (shorthand)
• innings — detailed inning-by-inning breakdown (inning1.run through inning9.run, plus extra innings)
• inningsBaseball — R-H-E totals: { hits, errors, run } — the classic baseball linescore summary
• status.code — 21=1st Inning, 22=2nd, … 29=9th Inning. Extra innings continue: 30=10th, etc.

Live (All)

GET /api/live/all

Raw live data for all baseball games (full detailed format with nested team objects).

Today’s Games

GET /api/today

Schedule by Date

GET /api/schedule/{date}

Date format: YYYY-MM-DD. Example: GET /api/schedule/2026-03-12

Live Tournaments

GET /api/live-tournaments

Leagues with live games right now.

Scheduled Tournaments

GET /api/scheduled-tournaments/{date}

Leagues with games on a specific date.

Newly Added Events

GET /api/newly-added-events

---

Baseball Status Codes

status.code	status.type	status.description	Meaning
0	"notstarted"	"Not started"	Game not yet started
21	"inprogress"	"1st Inning"	1st inning in progress
22	"inprogress"	"2nd Inning"	2nd inning
23–29	"inprogress"	"3rd"–"9th Inning"	Innings 3–9
30+	"inprogress"	"10th Inning"+	Extra innings
60	"postponed"	"Postponed"	Game postponed
70	"cancelled"	"Cancelled"	Game cancelled
100	"finished"	"Ended"	Game completed

Pattern: status.code = 20 + inning_number. So 1st inning = 21, 5th inning = 25, 9th inning = 29. Extra innings continue: 10th = 30, 11th = 31, etc.

---

Search & Discovery (7 endpoints)

Search

GET /api/search?q=yankees

Search teams, players, and tournaments.

Countries / Categories

GET /api/countries

Baseball categories and countries.

Countries (Extended)

GET /api/countries/all

Category Tournaments

GET /api/categories/{categoryId}/tournaments

Leagues in a country/category.

Trending Players

GET /api/trending-players

Baseball News

GET /api/news?lang=en

Country Flag

GET /api/country/{code}/flag