Skip to main content

​
Base URL

https://v2.hockey.sportsapipro.com

​
What’s Different in V2?

The V2 Hockey API provides enhanced data coverage with significantly more endpoints and richer data compared to V1:

88 Endpoints

Match, Tournament, Team, Player, Manager, Referee, Venue

Period-by-Period Scoring

P1, P2, P3, OT, and shootout scores with full player stats

Path Parameters

RESTful path parameters instead of query strings (e.g., /api/match/14198568)

Division/Conference Standings

7 standing groups: Eastern/Western conferences, Atlantic/Metropolitan/Central/Pacific divisions, plus overall

​
Authentication

Same x-api-key header as V1 — your existing API key works for both versions: 
curl -X GET "https://v2.hockey.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

​
V1 vs V2 Comparison

FeatureV1V2
Base URLv1.hockey.sportsapipro.comv2.hockey.sportsapipro.com
Parameter styleQuery strings (?gameId=123)Path parameters (/api/match/123)
Match endpoints818
Player endpoints215
Team endpoints214
Tournament endpoints312
Period Scores (P1-P3, OT, SO)❌✅
Play-by-Play (Incidents)❌✅
Manager/Referee Data❌✅
Venue/Arena Data❌✅

​
Important: Entity ID Discovery

Entity IDs (players, matches, teams, venues, referees) are numeric and must be discovered dynamically — never hardcode them.Discovery flow:
  1. Use /api/search?q=senators to find team/player IDs
  2. Use /api/live or /api/schedule/{date} to find match IDs
  3. Use /api/match/{id} to extract venue, referee, and player IDs from the response
  4. Use /api/tournament/{id}/seasons to discover valid season IDs

​
Key Hockey IDs for Testing

EntityNameID
TournamentNHL234
SeasonNHL 2025678476
TeamOttawa Senators3700
TeamMontréal Canadiens3690
MatchOttawa vs Montréal14198568

​
Ice Hockey-Specific Notes

Scoring: Ice hockey uses period1, period2, period3, overtime, penalties (shootout), normaltime, and current fields in the score object.Roster: Full team rosters with 20+ players including G (Goalie), D (Defense), LW/RW/C (Forwards).Incidents: Include goals, penalties, fights, and period breaks (not cards/substitutions).Standings: NHL standings come in 7 groups — Eastern/Western conferences, Atlantic/Metropolitan/Central/Pacific divisions, plus overall.Key Stats: Shots, saves, power play %, penalty minutes (PIM), faceoff %.National Team Stats: IIHF data available via /national-team-statistics.

​
Endpoint Categories

Live & Schedule (5)

Live scores, today’s games, schedule by date

Search & Discovery (5)

Search, countries, categories, country flags

Tournament (12)

Standings, stat types, events by round, venues

Match (18)

Lineups, statistics, incidents, odds, highlights

Player (15)

Statistics, characteristics, IIHF national team stats, events

Team (14)

Roster, performance, media, season stats

Manager / Referee / Venue (14)

Coach careers, referee stats, arena details, event history

​
Example Requests

curl -X GET "https://v2.hockey.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

​
UI Design Ideas

  • Scores display: Show period scores (P1, P2, P3) with OT/SO indicator if applicable
  • Match stats: Focus on shots on goal, save percentage, power play efficiency, penalty minutes, faceoff wins
  • Standings: Display as division tables (Atlantic, Metropolitan, Central, Pacific) with conference totals
  • Player profile: Show position (G/D/LW/RW/C), handedness (L/R), team, nationality
  • Roster view: Group by position (Goalies, Defensemen, Forwards) with jersey numbers