Live, Schedule & Search Endpoints

10 endpoints for live ice hockey scores, schedule, search, and discovery

Base URL

https://v2.hockey.sportsapipro.com

---

Live & Schedule (5 endpoints)

Live Matches

GET /api/live

Returns live hockey matches with period-by-period scores (P1, P2, P3, OT) and game status.

Example Response — /api/live

{
  "success": true,
  "count": 8,
  "events": [
    {
      "id": 14201585,
      "homeTeam": { "id": 3682, "name": "Colorado Avalanche" },
      "awayTeam": { "id": 257523, "name": "Vegas Golden Knights" },
      "homeScore": { "current": 2, "display": 2, "period1": 1, "period2": 1 },
      "awayScore": { "current": 2, "display": 2, "period1": 1, "period2": 1 },
      "periods": {
        "period1": { "home": 1, "away": 1 },
        "period2": { "home": 1, "away": 1 },
        "period3": {},
        "overtime": {}
      },
      "status": { "code": 2, "description": "2nd period", "type": "inprogress" },
      "tournament": "NHL",
      "tournamentId": 234,
      "season": "NHL 25/26",
      "seasonId": 78476,
      "startTimestamp": 1775952000
    }
  ],
  "timezone": { "name": "UTC", "source": "default", "utcOffset": "+00:00" }
}

Hockey-specific fields:

• periods — nested object with period1, period2, period3, overtime keys, each containing { home, away } goal counts (empty {} if period hasn’t started)
• status.code — 1=1st period, 2=2nd period, 3=3rd period, 4=overtime, 5=shootout
• Score objects also include flat period1, period2, period3 fields on homeScore/awayScore for quick access

Today’s Games

GET /api/today

Schedule by Date

GET /api/schedule/{date}

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

Live Tournaments

GET /api/live-tournaments

Tournaments with live games right now.

Newly Added Events

GET /api/newly-added-events

---

Hockey Status Codes

status.code	status.type	status.description	Meaning
0	"notstarted"	"Not started"	Game not yet started
1	"inprogress"	"1st period"	1st period in progress
2	"inprogress"	"2nd period"	2nd period
3	"inprogress"	"3rd period"	3rd period
4	"inprogress"	"Overtime"	Overtime period
5	"inprogress"	"Shootout"	Penalty shootout
31	"inprogress"	"Pause"	Between periods
60	"postponed"	"Postponed"	Game postponed
70	"cancelled"	"Cancelled"	Game cancelled
100	"finished"	"Ended"	Game completed

---

Search & Discovery (5 endpoints)

Search

GET /api/search?q={query}

Search players, teams, tournaments. Example: GET /api/search?q=ovechkin

Countries / Categories

GET /api/countries

Ice hockey categories/countries.

Countries (Extended)

GET /api/countries/all

Category Tournaments

GET /api/categories/{categoryId}/tournaments

Country Flag

GET /api/country/{code}/flag

Country flag image URL.