No Subscription to this function
GET /volleyball/get_competitions
Returns all competitions from an area.
Request URL
https://dsg-api.com/clients/{client_name}/volleyball/get_competitions?client={client_name}&authkey={client_authkey}
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)
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
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 area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
format
competition format to filter out leagues or cups
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
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
sport
sport of the API
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}/volleyball/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}/volleyball/get_competitions?client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/volleyball/get_competitions?client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"volleyball","lang":"en","method":{"method_id":"110","name":"get_competitions"},"competition":[{"competition_id":"1781","name":"CEV Champions League","teamtype":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-06-06 11:37:32"},{"competition_id":"1832","name":"CEV Women's Champions League","teamtype":"female","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:44"},{"competition_id":"1938","name":"CEV European Championship","teamtype":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1939","name":"CEV European Championship Qualifiers","teamtype":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1934","name":"CEV European League","teamtype":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1935","name":"CEV Silver European League","teamtype":"male","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1937","name":"CEV Women's European League","teamtype":"female","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1936","name":"CEV Silver Women's European League","teamtype":"female","type":"club","format":"international_cup","area_id":"7","area_name":"Europe","last_updated":"2018-02-05 15:43:51"},{"competition_id":"1777","name":"1. Bundesliga Männer","teamtype":"male","type":"club","format":"domestic_league","area_id":"80","area_name":"Germany","last_updated":"2019-03-28 01:24:42"},{"competition_id":"1778","name":"1. Bundesliga Frauen","teamtype":"male","type":"club","format":"domestic_league","area_id":"80","area_name":"Germany","last_updated":"2018-06-13 13:07:56"},{"competition_id":"1813","name":"SuperLega","teamtype":"male","type":"club","format":"domestic_league","area_id":"100","area_name":"Italy","last_updated":"2018-02-05 12:23:51"},{"competition_id":"1858","name":"V-League","teamtype":"female","type":"club","format":"domestic_league","area_id":"107","area_name":"Korea Republic","last_updated":"2018-03-06 12:38:28"},{"competition_id":"2374","name":"Men's NORCECA Championship","teamtype":"male","type":"international","format":"international_cup","area_id":"4","area_name":"N\/C America","last_updated":"2019-01-05 03:12:48"},{"competition_id":"1762","name":"PlusLiga","teamtype":"male","type":"club","format":"domestic_league","area_id":"155","area_name":"Poland","last_updated":"2018-06-06 11:36:56"},{"competition_id":"1847","name":"Efeler Ligi","teamtype":"male","type":"club","format":"domestic_league","area_id":"196","area_name":"Turkey","last_updated":"2018-10-13 01:29:22"},{"competition_id":"1769","name":"FIVB Volleyball Men's Nations League","teamtype":"male","type":"international","format":"domestic_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:47"},{"competition_id":"1770","name":"FIVB Volleyball Women's Nations League","teamtype":"female","type":"international","format":"domestic_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:49"},{"competition_id":"1265","name":"FIVB Men's Club World Championship","teamtype":"male","type":"club","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:38"},{"competition_id":"1263","name":"FIVB Women's Club World Championship","teamtype":"female","type":"club","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:40"},{"competition_id":"1771","name":"FIVB Men's World Championship","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:51"},{"competition_id":"1314","name":"FIVB Women's World Championship","teamtype":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:46"},{"competition_id":"1266","name":"FIVB Volleyball World League","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:42"},{"competition_id":"1267","name":"FIVB World Grand Prix","teamtype":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:44"},{"competition_id":"1772","name":"FIVB Men's World Grand Champions Cup","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:53"},{"competition_id":"1773","name":"FIVB Women's World Grand Champions Cup","teamtype":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:55"},{"competition_id":"1971","name":"FIVB Men's World Cup","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:53"},{"competition_id":"1972","name":"FIVB Women's World Cup","teamtype":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:55"},{"competition_id":"2372","name":"Montreux Volley Masters","teamtype":"female","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-06-27 09:39:55"}]}}