Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.
softnetsport
statscore.com/v2/participants/{participant_id}
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/participants.show.xsd
MethodGET

Description

Returns
the
a single
participant informationPackageThis resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages
participants information
Cache60 seconds
Authorization requiredYes

Method parameters

NameData typeDescription
participant_idxsd:intREQUIRED. The requested participant identifier

Query parameters

NameData typeDescription
tokenxsd:stringREQUIRED.
More
 More information concerning
oAuth token: oAuth 2.0 authorization
authorization in API introduction section
langxsd:string

Determines language for the output data

. softnetSPORT API provides the following languages: languages.index

 


Method calling examples

Link
Description
https://api.
softnetsport
statscore.com/v2/participants/136928
.xml
?token={{YOUR_TOKEN}}Returns detailed data for
the
a single participant: FC Barcelona in
XML formathttps://api.softnetsport.com/v2/participants/136928?token={{YOUR_TOKEN}}Returns detailed data for the single participant: FC Barcelona in
JSON format

Output elements

...

.participant
 idUnique identifier of the
participants
participants > participant
type

Include Page
Participant

type. Possible values:
  • team
  • person
nameParticipant nameshort_nameParticipant short name, max length: 20 charactersacronymMax 3 characters length mini name, f.e: BAR, REAgender

Participant gender. Possible value:

  • male
  • female
  • mixed (for doubles in tennis f.e)
area_idUnique identifier of the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_nameArea name represented by the participantarea_codeMax 3 characters length of the short area name f.e: GER, POL, FRAsport_idUnique identifier of the sport in which participant occures. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which participant occuresnational

Determines if participant is national team. Possible values:

  • yes
  • no
websiteParticipant official websiteutInformation about date and time when the record was last updated. Format UNIX_TIMESTAMPold_participant_iddeprecated. The attribute will be deprecated in next API versionslugfriendly url for participantlogoAttribute for internal purposes..details 

node
Participant node

participants > participant > details
participants > participant > details > detail


foundedDate when the team was founded
phonePhone number
emailEmail address
address
Addres when
Address where the team is located
venue_idUnique identifier
of
for the venue in which the team
is playing
plays home games
venue_nameName of the venue in which the team
is playing
plays home games
weight
Participant
Participants weight
height
Participant
Participants height
nickname
Participant
Participants nickname
position_nameName of the participants position
position_idUnique identifier of the
participant
participants position
birthdate
Participant birthdate
Participants date of birth
born_place
Participant born
Participants place of birth
is_retired

Determines if participant

is

has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director

 

  • athlete/coach


participants > participant > venues
participants > participant > venues > venue


idUnique identifier for the season.
nameName of the season e.g. Premiership 2014/15
short_nameShort name of the venue
countryCountry in which the venue is place
statusStatus of the venue
urlUrl of the venue's website
cityCity in which the venue is place
latLatitude of the venue
lngLongitude of the venue
openedDate when the venue was opened
photoPhoto of the venue
utInformation about the date and time of when the venue record was last updated.