swiss unihockey tournaments Endpoint Documentation

/rest/v1.0/tournaments
Read methods
Name Value and Notes
Method / Path: GET /
Description: Returns all tournaments of the selected season.
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
Response formats: xml
Status codes: 200: OK — Returning the found tournaments.
404: Not Found — No tournament could be found.
Testing: Test form (click to reveal)
Name Value and Notes
Method / Path: GET /{tournamentcode}/groups
Description: Returns all groups of the selected tournament.
Path parameters: tournamentcode: The tournament code
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
Response formats: xml
Status codes: 200: OK — Returning the found groups.
404: Not Found — No group could be found.
Testing: Test form (click to reveal)
Name Value and Notes
Method / Path: GET /{tournamentcode}/groups/{group}/games
Description: Returns games of the selected tournament and group.
Path parameters: tournamentcode: The tournament code
group: The group
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
club: The club identifier or club name (min. 5 characters)
status: The game status (default: ignore parameter): 'planned' (games in future only) or 'played' (played games only)
limit: The maximum number of games returned [10]
order: Games in output sorted by date in ascending (ASC) or descending (DESC) order [ASC]
Response formats: xml
Status codes: 200: OK — Returning found games.
404: Not Found — No games could be found.
400: Bad Request — Given club name is too short (at least 5 characters are required).
Testing: Test form (click to reveal)
Name Value and Notes
Method / Path: GET /{tournamentcode}/groups/{group}/teams
Description: Returns the teams for the selected tournament and group.
Path parameters: tournamentcode: The tournament code
group: The group
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
Response formats: xml
Status codes: 200: OK — Returning found teams.
404: Not Found — No team could be found.
Testing: Test form (click to reveal)
Name Value and Notes
Method / Path: GET /{tournamentcode}/groups/{group}/table
Description: Returns the table for the selected tournament and group.
Path parameters: tournamentcode: The tournament code
group: The group
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
Response formats: xml
Status codes: 200: OK — Returning the found table.
404: Not Found — No table could be found.
Testing: Test form (click to reveal)
Name Value and Notes
Method / Path: GET /{tournamentcode}/games
Description: Returns games of the selected tournament.
Path parameters: tournamentcode: The tournament code
Required (form) parameters: apikey: Valid API key registered at swiss unihockey
Optional (query) parameters: season: The season (if parameter is omitted current season is set)
club: The club identifier or club name (min. 5 characters)
status: The game status (default: ignore parameter): 'planned' (games in future only) or 'played' (played games only)
limit: The maximum number of games returned [50]
order: Games in output sorted by date in ascending (ASC) or descending (DESC) order [ASC]
Response formats: xml
Status codes: 200: OK — Returning found games.
404: Not Found — No games could be found.
400: Bad Request — Given club name is too short (at least 5 characters are required).
Testing: Test form (click to reveal)