Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /rugby/get_venue
Returns list of details for certain venues
Request URL
https://dsg-api.com/clients/{client_name}/rugby/get_venue?id={venue_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
object id to return
Nodes
competition❯
details about the competition
competition_id
unique identifier for a competition
competition_name
name of the competition
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 or team)
gender❯
details about the gender
age_group
defines the age group (senior,u23,u22,u21....)
value
gender type (male, female or mixed)
match❯
details about the match
date
date of match, format 'yyyy-mm-dd' (CET)
date_utc
date of match, format 'yyyy-mm-dd' (UTC)
final_period
display the period in which the match finished.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match
score_a
full-time score of team_a
score_b
full-time score of team_b
status
status of the game
team_a_area_code
three-letter-acronym of the area where the home team origins
team_a_area_id
unique area_id for team_a
team_a_area_name
area name of home team origins county
team_a_id
unique team ID for team_a
team_a_logo
team logo URL
team_a_name
current name of team_a
team_a_original_name
the real name at the particular season (so can differ to current name)
team_a_short_name
short name of the home team
team_a_tla_name
three-letter-acronym of team_a
team_b_area_code
three-letter-acronym of the area where the home team origins
team_b_area_id
unique area_id for team_b
team_b_area_name
area name of away team origins county
team_b_id
unique team ID for team_b
team_b_logo
team logo URL
team_b_name
current name of team_b
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of team_b
team_b_tla_name
three-letter-acronym of team_b
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'
venue_type
determines if the match is on neutral ground or on home/away basis
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
match_extra❯
extra informations about the match
attendance
amount of people that attended the particular match
gameweek
contains the gameweek a match belongs to.
method❯
details about the API function
method_id
unique ID of method
name
name of method
period❯
details about periods of the match
score_a
period score of team_a
score_b
period score of team_b
type
three-letter-acronym of the period
round❯
basic details about the updated round
round_id
unique identifier of round
round_name
name of the round
season❯
details about the updated season
season_id
unique identifier for season
season_name
name of the competition for this particular season (including sponsor names etc)
season_title
title of season
venue❯
details about the venue
address
name of street and street number
address_zip
ZIP code
area_id
unique identifier for an area
area_name
name of the area
capacity
maximum capacity of the venue
city_id
unique identifier for cities
city_name
name of the city
geo_latitude
latitude coordinates of venue
geo_longtitude
longitude coordinates of venue
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
current name of the venue
nicknames
nicknames of the venue. If more as 1 then seperated with a ","
opened
year venue was opened. Format 'yyyy'
status
the current status of the venue ('open' or 'demolished')
surface
type of surface
venue_id
unique identifier of the venue
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}/rugby/get_venue?id={venue_id}&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}/rugby/get_venue?id={venue_id}&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}/rugby/get_venue?id={venue_id}&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}/rugby/get_venue?id={venue_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example200 Success{"datasportsgroup":{"version":"1.0","sport":"rugby","lang":"en","method":{"method_id":"235","name":"get_venue"},"venue":{"venue_id":"1266","name":"Altrad Stadium","city":"Montpellier","area":"France","last_updated":"2018-09-25 15:28:33","adress":"Avenue de Vanières, Quartier Ovalie","adress_zip":"34070","opened":"2007","status":"open","nicknames":"Stade Yves du Manoir, GGL Stadium","geo_latitude":"43.593041","geo_longtitude":"3.849611","capacity":"14700","surface":"grass"}}}