Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /swimming/get_disciplines
Returns a list of support disciplines
Request URL
https://dsg-api.com/clients/{client_name}/swimming/get_disciplines?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
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
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
discipline❯
basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
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}/swimming/get_disciplines?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}/swimming/get_disciplines?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}/swimming/get_disciplines?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}/swimming/get_disciplines?client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.487.3","sport":"swimming","lang":"en","generated_utc":"2025-08-01T15:08:25+00:00","method":{"method_id":"487","name":"get_disciplines"},"discipline":[{"discipline_id":"1","name":"50m Freestyle","type":"contestant"},{"discipline_id":"2","name":"100m Freestyle","type":"contestant"},{"discipline_id":"3","name":"200m Freestyle","type":"contestant"},{"discipline_id":"4","name":"400m Freestyle","type":"contestant"},{"discipline_id":"5","name":"1500m Freestyle","type":"contestant"},{"discipline_id":"6","name":"4 x 100m Medley Relay","type":"team"},{"discipline_id":"8","name":"50m Backstroke","type":"contestant"},{"discipline_id":"9","name":"100m Backstroke","type":"contestant"},{"discipline_id":"10","name":"200m Backstroke","type":"contestant"},{"discipline_id":"12","name":"50m Breaststroke","type":"contestant"},{"discipline_id":"13","name":"100m Breaststroke","type":"contestant"},{"discipline_id":"14","name":"200m Breaststroke","type":"contestant"},{"discipline_id":"16","name":"50m Butterfly","type":"contestant"},{"discipline_id":"17","name":"100m Butterfly","type":"contestant"},{"discipline_id":"18","name":"200m Butterfly","type":"contestant"},{"discipline_id":"19","name":"200m Individual Medley","type":"contestant"},{"discipline_id":"20","name":"400m Individual Medley","type":"contestant"},{"discipline_id":"21","name":"4 x 100m Freestyle Relay","type":"team"},{"discipline_id":"22","name":"4 x 200m Freestyle Relay","type":"team"},{"discipline_id":"90","name":"800m Freestyle","type":"contestant"},{"discipline_id":"279","name":"5km","type":"contestant"},{"discipline_id":"280","name":"10km","type":"contestant"},{"discipline_id":"281","name":"5km Team","type":"team"},{"discipline_id":"282","name":"25km Team","type":"team"},{"discipline_id":"544","name":"Para - 50m Freestyle S7","type":"contestant"},{"discipline_id":"545","name":"Para - 50m Freestyle S13","type":"contestant"},{"discipline_id":"546","name":"Para - 200m Freestyle S14","type":"contestant"},{"discipline_id":"547","name":"Para - 100m Backstroke S9","type":"contestant"},{"discipline_id":"548","name":"Para - 100m Breaststroke SB8","type":"contestant"},{"discipline_id":"549","name":"Para - 100m Butterfly S10","type":"contestant"},{"discipline_id":"550","name":"Para - 100m Freestyle S9","type":"contestant"},{"discipline_id":"551","name":"Para - 100m Backstroke S8","type":"contestant"},{"discipline_id":"552","name":"Para - 100m Breaststroke SB6","type":"contestant"},{"discipline_id":"553","name":"Para - 200m Individual Medley SM10","type":"contestant"},{"discipline_id":"736","name":"Para - 400m Freestyle S9","type":"contestant"},{"discipline_id":"737","name":"Para - 100m Backstroke S2","type":"contestant"},{"discipline_id":"738","name":"Para - 100m Backstroke S1","type":"contestant"},{"discipline_id":"739","name":"Para - 100m Butterfly S14","type":"contestant"},{"discipline_id":"740","name":"Para - 50m Freestyle S6","type":"contestant"},{"discipline_id":"741","name":"Para - 50m Freestyle S10","type":"contestant"},{"discipline_id":"742","name":"Para - 50m Breaststroke SB3","type":"contestant"},{"discipline_id":"743","name":"Para - 100m Butterfly S13","type":"contestant"},{"discipline_id":"744","name":"Para - 200m Freestyle S5","type":"contestant"},{"discipline_id":"779","name":"Para - 100m Freestyle S5","type":"contestant"},{"discipline_id":"780","name":"Para - 100m Freestyle S4","type":"contestant"},{"discipline_id":"781","name":"Para - 200m Individual Medley SM6","type":"contestant"},{"discipline_id":"782","name":"Para - 400m Freestyle S11","type":"contestant"},{"discipline_id":"783","name":"Para - 100m Breaststroke SB9","type":"contestant"},{"discipline_id":"784","name":"Para - 100m Backstroke S13","type":"contestant"},{"discipline_id":"785","name":"Para - 4 x 50m Freestyle Relay 20 Points","type":"team"},{"discipline_id":"840","name":"Para - 100m Backstroke S12","type":"contestant"},{"discipline_id":"841","name":"Para - 400m Freestyle S13","type":"contestant"},{"discipline_id":"842","name":"Para - 50m Backstroke S2","type":"contestant"},{"discipline_id":"843","name":"Para - 200m Individual Medley SM7","type":"contestant"},{"discipline_id":"844","name":"Para - 50m Freestyle S11","type":"contestant"},{"discipline_id":"845","name":"Para - 50m Backstroke S1","type":"contestant"},{"discipline_id":"901","name":"Para - 100m Freestyle S10","type":"contestant"},{"discipline_id":"902","name":"Para - 200m Individual Medley SM8","type":"contestant"},{"discipline_id":"903","name":"Para - 100m Backstroke S11","type":"contestant"},{"discipline_id":"904","name":"Para - 150m Individual Medley SM4","type":"contestant"},{"discipline_id":"905","name":"Para - 150m Individual Medley SM3","type":"contestant"},{"discipline_id":"906","name":"Para - 100m Breaststroke SB5","type":"contestant"},{"discipline_id":"907","name":"Para - 4 x 100m Freestyle Relay S14","type":"team"},{"discipline_id":"908","name":"Para - 400m Freestyle S7","type":"contestant"},{"discipline_id":"909","name":"Para - 50m Freestyle S9","type":"contestant"},{"discipline_id":"910","name":"Para - 50m Backstroke S3","type":"contestant"},{"discipline_id":"911","name":"Para - 100m Breaststroke SB14","type":"contestant"},{"discipline_id":"912","name":"Para - 100m Breaststroke SB4","type":"contestant"},{"discipline_id":"913","name":"Para - 200m Freestyle S2","type":"contestant"},{"discipline_id":"914","name":"Para - 4 x 100m Medley Relay 34 Points","type":"team"},{"discipline_id":"972","name":"Para - 100m Backstroke S7","type":"contestant"},{"discipline_id":"973","name":"Para - 100m Backstroke S9","type":"contestant"},{"discipline_id":"974","name":"Para - 200m Freestyle S4","type":"contestant"},{"discipline_id":"975","name":"Para - 50m Butterfly S6","type":"contestant"},{"discipline_id":"976","name":"Para - 50m Backstroke S5","type":"contestant"},{"discipline_id":"977","name":"Para - 200m Individual Medley SM11","type":"contestant"},{"discipline_id":"978","name":"Para - 100m Freestyle S3","type":"contestant"},{"discipline_id":"979","name":"Para - 200m Individual Medley SM13","type":"contestant"},{"discipline_id":"983","name":"Para - 100m Freestyle S12","type":"contestant"},{"discipline_id":"984","name":"Para - 200m Individual Medley SM14","type":"contestant"},{"discipline_id":"985","name":"Para - 400m Freestyle S8","type":"contestant"},{"discipline_id":"986","name":"Para - 50m Breaststroke SB2","type":"contestant"},{"discipline_id":"987","name":"Para - 100m Freestyle S7","type":"contestant"},{"discipline_id":"988","name":"Para - 4 x 100m Freestyle Relay 49 Points","type":"team"},{"discipline_id":"996","name":"Para - 100m Breaststroke SB7","type":"contestant"},{"discipline_id":"997","name":"Para - 50m Freestyle S5","type":"contestant"},{"discipline_id":"998","name":"Para - 100m Freestyle S6","type":"contestant"},{"discipline_id":"999","name":"Para - 400m Freestyle S10","type":"contestant"},{"discipline_id":"1000","name":"Para - 100m Breaststroke SB11","type":"contestant"},{"discipline_id":"1001","name":"Para - 200m Individual Medley SM9","type":"contestant"},{"discipline_id":"1002","name":"Para - 100m Breaststroke SB13","type":"contestant"},{"discipline_id":"1003","name":"Para - 100m Breaststroke SB12","type":"contestant"},{"discipline_id":"1004","name":"Para - 50m Freestyle S8","type":"contestant"},{"discipline_id":"1005","name":"Para - 4 x 50m Medley Relay 20 Points","type":"team"},{"discipline_id":"1017","name":"Para - 400m Freestyle S6","type":"contestant"},{"discipline_id":"1018","name":"Para - 50m Butterfly S5","type":"contestant"},{"discipline_id":"1019","name":"Para - 100m Backstroke S10","type":"contestant"},{"discipline_id":"1020","name":"Para - 100m Butterfly S9","type":"contestant"},{"discipline_id":"1021","name":"Para - 100m Backstroke S14","type":"contestant"},{"discipline_id":"1022","name":"Para - 50m Freestyle S3","type":"contestant"},{"discipline_id":"1023","name":"Para - 50m Freestyle S4","type":"contestant"},{"discipline_id":"1024","name":"Para - 100m Butterfly S11","type":"contestant"},{"discipline_id":"1025","name":"Para - 100m Freestyle S8","type":"contestant"},{"discipline_id":"1037","name":"Para - 100m Backstroke S6","type":"contestant"},{"discipline_id":"1038","name":"Para - 100m Butterfly S8","type":"contestant"},{"discipline_id":"1039","name":"Para - 50m Butterfly S7","type":"contestant"},{"discipline_id":"1040","name":"Para - 50m Backstroke S4","type":"contestant"},{"discipline_id":"1041","name":"Para - 100m Butterfly S12","type":"contestant"},{"discipline_id":"1042","name":"Para - 100m Freestyle S11","type":"contestant"},{"discipline_id":"1043","name":"Para - 200m Freestyle S3","type":"contestant"},{"discipline_id":"1044","name":"Para - 200m Individual Medley SM5","type":"contestant"},{"discipline_id":"1045","name":"Para - 4 x 100m Freestyle Relay 34 Points","type":"team"},{"discipline_id":"1060","name":"4 x 1500m Freestyle Relay","type":"team"},{"discipline_id":"1072","name":"100m Individual Medley","type":"contestant"},{"discipline_id":"1085","name":"3km Knockout Sprint","type":"contestant"}]}}