Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /ice_hockey/get_competitions
Returns all competitions from an area.
Request URL
https://dsg-api.com/clients/{client_name}/ice_hockey/get_competitions?client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
area_id
int
area to get the subareas or specific area from
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
lang
string
two-character language code, defaults to 'en'
Nodes
area
details about area
area_id
unique identifier for an area
country_code
three character country code
iso_code
official three character ISO code (not all areas will have an ISO code)
name
name of the area
parent_area_id
unique identifier of the parent area (either continent or World)
competition
details about competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
format
competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition
type
determines if a competition is between club teams (club) or national teams (international)
datasportsgroup
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API call
sport
sport value
version
version of the API
method
details about the API function
method_id
unique ID of method
name
name of method
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/ice_hockey/get_competitions?client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);
?>
curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/ice_hockey/get_competitions?client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/ice_hockey/get_competitions?client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/ice_hockey/get_competitions?client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.77.3","sport":"ice_hockey","lang":"en","generated_utc":"2025-08-01T15:04:18+00:00","method":{"method_id":"77","name":"get_competitions"},"competition":[{"competition_id":"4523","name":"ICE Hockey League","gender":"male","type":"club","format":"domestic_league","area_id":"20","area_name":"Austria","last_updated":"2023-02-17 13:32:29"},{"competition_id":"4524","name":"Alps Hockey League","gender":"male","type":"club","format":"domestic_league","area_id":"20","area_name":"Austria","last_updated":"2023-02-17 13:32:29"},{"competition_id":"1095","name":"OHL","gender":"male youth","type":"club","format":"domestic_league","area_id":"43","area_name":"Canada","last_updated":"2021-07-09 11:16:31"},{"competition_id":"1096","name":"LHJMQ","gender":"male youth","type":"club","format":"domestic_league","area_id":"43","area_name":"Canada","last_updated":"2021-07-09 11:16:31"},{"competition_id":"1097","name":"WHL","gender":"male youth","type":"club","format":"domestic_league","area_id":"43","area_name":"Canada","last_updated":"2021-07-09 11:16:31"},{"competition_id":"1628","name":"ELH","gender":"male","type":"club","format":"domestic_league","area_id":"59","area_name":"Czechia","last_updated":"2022-01-07 18:29:45"},{"competition_id":"5163","name":"Playoffs 1\/2","gender":"male","type":"club","format":"playoff","area_id":"59","area_name":"Czechia","last_updated":"2024-11-25 12:49:03"},{"competition_id":"2437","name":"Champions Hockey League","gender":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2021-07-09 11:16:31"},{"competition_id":"1627","name":"SM-liiga","gender":"male","type":"club","format":"domestic_league","area_id":"75","area_name":"Finland","last_updated":"2021-11-17 17:49:27"},{"competition_id":"4049","name":"Ligue Magnus","gender":"male","type":"club","format":"domestic_league","area_id":"76","area_name":"France","last_updated":"2023-02-17 13:32:29"},{"competition_id":"1503","name":"DEL","gender":"male","type":"club","format":"domestic_league","area_id":"80","area_name":"Germany","last_updated":"2025-01-02 22:39:41"},{"competition_id":"4782","name":"Elite Ice Hockey League","gender":"male","type":"club","format":"domestic_league","area_id":"250","area_name":"Great Britain","last_updated":"2021-11-17 17:49:27"},{"competition_id":"4522","name":"EliteHockey Ligaen","gender":"male","type":"club","format":"domestic_league","area_id":"146","area_name":"Norway","last_updated":"2023-02-17 13:32:29"},{"competition_id":"975","name":"KHL","gender":"male","type":"club","format":"domestic_league","area_id":"160","area_name":"Russia","last_updated":"2021-07-09 11:16:31"},{"competition_id":"1857","name":"Tipsport liga","gender":"male","type":"club","format":"domestic_league","area_id":"171","area_name":"Slovakia","last_updated":"2021-11-15 18:02:31"},{"competition_id":"2894","name":"SHL","gender":"male","type":"club","format":"domestic_league","area_id":"184","area_name":"Sweden","last_updated":"2021-07-09 11:16:31"},{"competition_id":"4047","name":"HockeyAllsvenskan","gender":"male","type":"club","format":"domestic_league","area_id":"184","area_name":"Sweden","last_updated":"2023-02-16 11:48:58"},{"competition_id":"2897","name":"National League","gender":"male","type":"club","format":"domestic_league","area_id":"185","area_name":"Switzerland","last_updated":"2021-07-09 11:16:31"},{"competition_id":"986","name":"NHL","gender":"male","type":"club","format":"domestic_league","area_id":"203","area_name":"United States","last_updated":"2021-07-09 11:16:31"},{"competition_id":"4525","name":"NHL Preseason","gender":"male","type":"club","format":"unofficial","area_id":"203","area_name":"United States","last_updated":"2023-10-06 19:39:16"},{"competition_id":"3449","name":"Winter Olympics","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2021-12-22 11:24:08"},{"competition_id":"3450","name":"Winter Olympics","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2021-12-22 11:24:18"},{"competition_id":"1922","name":"IIHF World Championship","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-01 15:53:05"},{"competition_id":"3546","name":"IIHF World Championship Divison I","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-06-27 14:53:27"},{"competition_id":"3547","name":"IIHF World Championship Divison II","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-06-27 14:53:25"},{"competition_id":"3548","name":"IIHF World Championship Divison III","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-06-27 14:53:23"},{"competition_id":"3549","name":"IIHF World Championship Divison IV","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-06-27 14:53:21"},{"competition_id":"4754","name":"Winter Olympics Qualification","gender":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2024-02-09 14:20:03"},{"competition_id":"4755","name":"Winter Olympics Qualification","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2024-02-09 14:20:05"},{"competition_id":"2937","name":"IIHF World Championship U20","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-03 15:50:37"},{"competition_id":"3691","name":"IIHF World Championship U20 Division I","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-02-04 10:20:19"},{"competition_id":"3692","name":"IIHF U20 World Championship Division II","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-12-11 14:20:39"},{"competition_id":"3693","name":"IIHF U20 World Championship Division III","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-12-11 14:21:45"},{"competition_id":"3685","name":"IIHF World Championship U18","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-03 15:50:47"},{"competition_id":"3686","name":"IIHF World Championship U18 Division I","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-03 15:50:49"},{"competition_id":"3687","name":"IIHF World Championship U18 Division II","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-03 15:50:51"},{"competition_id":"3688","name":"IIHF World Championship U18 Division III","gender":"male youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2022-05-03 15:50:53"},{"competition_id":"4014","name":"IIHF Women's World Championship","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-04-03 12:14:10"},{"competition_id":"4015","name":"IIHF Women's World Championship Div I","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-04-03 12:14:12"},{"competition_id":"4016","name":"IIHF Women's World Championship Div II","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-04-03 12:14:14"},{"competition_id":"1723","name":"IIHF Women's World Championship Div II Q","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-04-03 12:14:03"},{"competition_id":"4017","name":"IIHF Women's World Championship Div III","gender":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-04-03 12:13:44"},{"competition_id":"4018","name":"IIHF Women's World Championship U18","gender":"female youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-02-04 14:47:35"},{"competition_id":"4019","name":"IIHF Women's World Championship U18 Division I","gender":"female youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-02-04 14:47:35"},{"competition_id":"4020","name":"IIHF Women's World Championship U18 Division II","gender":"female youth","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2023-02-04 14:47:35"}]}}