How do I make my first call?
Get a free key, then call GET /v1/games?date=today with it in the Authorization: Bearer header. The documentation has the same call in curl, Python, JavaScript and PHP.
Read the quick startIce Hockey API Support
Answers in seconds, a person when you need oneKeys, plans, leagues, box scores, odds and billing, answered below. Anything else goes to a ticket, and a person who works on the data reads it.
Right now · the latest resultsAll running
1,275
Leagues
47
Games today
30
Answers below
- Ligue MagnusRouen 1:2 Angersstarted 2h agoFinal
- OHLWindsor Spitfires 2:3 Saginaw SpiritOT, started 3h agoFinal
- QMJHLBlainville-Boisbriand Armada 6:2 Victoriaville Tigresstarted 3h agoFinal
- QMJHLGatineau Olympiques 2:3 Chicoutimi Sagueneensstarted 3h agoFinal
Before you write
Most answers are one click awaySystem status
Whether the website, the API and the MCP server are up, checked every minute, and any incident open now.
See statusDocumentation
Every endpoint with a working example, the guides, and Try it with your own key.
Read the docsYour keys
Make a key, see its calls today against your limit, or retire one you have shared.
Open your keysBilling and refunds
Change or cancel a plan, see your receipts, or ask for a refund with the form.
Open billingMCP server
Connect Claude or another assistant to the data with your key, in two steps.
Set up MCPAnswers
Questions developers ask usEvery answer is written by the people who build the data, and links to the page with the full detail.
Getting started
Is there a free key, and what does it read?
Yes, with no card: yesterday, today and the games scheduled ahead in every league, 50 calls a day and 10 a minute. Past seasons and odds need a paid plan.
Compare the plansWhich leagues do you cover?
Over 1,200 leagues and tournaments, from the NHL and the big European leagues to junior and lower tiers, with seasons back to 1917. /v1/leagues lists them all.
Browse the leaguesCan I use it from Claude or another assistant?
Yes. The MCP server gives an assistant the same data as the API, with your key. It takes two steps to connect.
Set up the MCP serverKeys and plans
How do I send my key?
In the Authorization: Bearer header or in X-API-Key. A key in the address is refused, so it never ends up in a log.
Read about keysWhich plan has the old seasons?
Archive has every past season back to 1917. Complete has those and the current seasons together, with the highest limits.
See what each plan readsWhat happens when I reach my limit?
Calls past the limit get a 429 with the time it resets. Every reply carries X-RateLimit-Remaining, so you can slow down before it happens.
Read about limitsCan I have more than one key?
Yes, as many as you need, each with its own name and its own count of calls. They share your plan’s limit.
Open your keysCan I pay yearly?
Yes. A yearly plan costs ten months, so two months are free.
See the yearly pricesThe data
Which leagues have goals, line-ups and player lines?
The NHL from 1917, Liiga, the SHL and HockeyAllsvenskan, the AHL, ECHL, OHL, WHL, QMJHL and USHL, the KHL, MHL and VHL, the Czech Extraliga, the DEL and DEL2, and the Swiss National League and Swiss League. /v1/coverage lists the seasons for each.
Read about box scoresWhat is in a box score?
Periods, every goal with scorer, assists and strength, every penalty, skater lines (goals, assists, plus/minus, shots, blocks, faceoffs, time on ice) and goalie lines, plus officials and attendance where the league records them.
See a full box scoreDo you have shot positions?
For the NHL from 2009-10: every shot with its rink position, shooter and goalie. Earlier NHL seasons name the shooter and goalie on each shot without a position.
Read about play by playWhich odds do you have?
Three-way, moneyline, puck line and totals, as opening, closing and average prices, for finished games in every league we price.
Read about oddsWhy is a very old game’s date empty?
Some early games are recorded with their season but not their day. Their date is null rather than a guess.
Read about datesA score looks wrong. What do I do?
Open a ticket with the game’s id. We check it against the league’s own record and correct it at the source, so the fix reaches every call.
Report a scoreLive and freshness
How soon does a result arrive?
Within about 10 minutes of the final buzzer in every league, with the start time and whether it ended in regulation, overtime or a shootout. Times are UTC.
Read about resultsDo you have games in progress?
Yes, for the NHL: the score, the period and the clock, read every minute while a game is on.
Read about live gamesHow do I see how many calls I have used?
Your account shows each key’s calls by day, and /v1/usage gives the same figures to your code.
Read about usageHow do I know if something is down?
The status page shows the website, the API and the MCP server, checked every minute, with any incident and its updates.
See statusIds and names
Are ids stable?
Yes. A game, team, player or league keeps its id for good, even when a club is renamed or moves city.
Read about idsCan I look a team up by its name?
Yes. Names are matched loosely, so ska, SKA St Petersburg and the team’s id all find the same team.
Read about searchHow are renamed clubs handled?
A club keeps one id through every name it has had, and each season lists the name it played under that year.
Read about renamed clubsBilling and account
How do I cancel?
From your account, under Billing. Your plan runs to the end of the period you paid for, and no further charge is made.
Read the refund rulesHow do I ask for a refund?
With the form on the Refunds page. Refunds are only asked for that way, never by email.
Open the refund formWhat shows on my card statement?
Charges show as DEVELOPERDATA.NET, the company that runs Ice Hockey API.
Read the termsWhere are my receipts?
Under Billing in your account: the payment page there holds your card and every receipt.
Open billingHow do I change plan?
Under Billing in your account. A move up starts at once, with the difference charged.
Change your planHow do I delete my account?
From your account. Your keys stop at once, and your account and tickets are deleted within 30 days.
Read the privacy noticeUsing the data
Can I show the data in my app or site?
Yes, in your own product. Passing the data on as a feed or a copy of the database is not allowed.
Read the terms of useCan I fetch a whole season at once?
Yes. A season’s games come in pages of up to 200, so a full season is a handful of calls.
Read about pagingNo answer matches that yet. We note every search that finds nothing and write the answer.
Ask us insteadTalk to us
Open a ticket, a person answersSign in and your tickets stay together under My tickets. Not signed in? You can still open one and read our answer at its private link.
When we answer
| Every ticket | a person, usually within a working day |
| Paid plans | first in the queue |
| A wrong score or a missing game | fixed at the source, for every call |
Help us answer first time
- The call you made, with its parameters
- The game, team or league and the date
- The last four characters of your key, never all of it
What a ticket's state means
Answered: your turnWe replied; read it and reply or close it
With usWe are on it; nothing needed from you
ClosedSorted; reply to open it again
Not a customer yet
Try the data before you ask anythingA free key reads yesterday, today and the games ahead in every league, 50 calls a day, no card.