Taso API
FORMAT: 1A HOST: https://[organiser_url, ask from tuki@torneopal.fi]
Most API calls require an api_key. You need to get this key from the competition organiser.
Use the api_key only between your server and the competition server. Never embed the key to a web page or an application.
Results are cached for up to 1 minute unless otherwise stated.
/*MD
/*MD
/*MD
/*MD
Competition ¶
Season list ¶
Headers
Content-Type: application/json
Body
seasons: [
{
season_id: "2015",
season_description: "Jalkapallo 2015",
sport_id: "football"
},
{
season_id: "2016",
season_description: "Jalkapallo 2016",
sport_id: "football"
},
{
season_id: "2016-17",
season_description: "Futsal 2016-17",
sport_id: "futsal"
},
{
season_id: "2017",
season_description: "Jalkapallo 2017",
sport_id: "football"
}
]
Get seasonsGET/taso/rest/getSeasons{?api_key,sport_id}
Field | Type | Description |
---|---|---|
season_id | string | |
season_description | string | |
sport_id | string |
- api_key
string
(required)API key got from provider
- sport_id
string
(optional) Example: footballOnly list current seasons a specific sport (see getSports)
Season ¶
Headers
Content-Type: application/json
Body
[
{
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser" : "spl",
"organiser_name" : "Suomen Palloliitto",
"sport_id" : "football"
},
{
"competition_id": "hki15",
"competition_name": "SPL Helsinki Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser" : "splhelsinki",
"organiser_name" : "Helsingin piiri",
"sport_id" : "football"
},
{
"competition_id": "splfutsal1516",
"competition_name": "SPL Futsal 2015-16",
"competition_status": "published",
"season_id": "2015-16",
"organiser" : "spl",
"organiser_name" : "Suomen Palloliitto",
"sport_id" : "futsal"
},
]
Schema
{
"type": "array",
"competitions": {
"type": "object",
"properties": {
"competition_id": {
"description": "Unique id of the competition",
"type": "string"
},
"competition_name": {
"description": "Name of the competition",
"type": "string"
},
"competition_status": {
"description": "Publishing status competition",
"type": "string",
"values": "[planned,published,archived]"
},
"season_id": {
"description": "Season that this competition belongs to",
"type": "string",
"values": "eg. 2015, 2016-17"
},
"organiser": {
"description": "Competition organiser id",
"type": "string",
"values": "eg. spl,splhelsinki,spluusimaa,spltampere ..."
},
"organiser_name": {
"description": "Organiser name",
"type": "string",
"values": "Suomen Palloliitto, Helsingin piiri, Uudenmaan piiri, Tampereen piiri"
}
}
}
}
Get seasonGET/taso/rest/getSeason{?season_id}
Field | Type | Description |
---|
- season_id
string
(required) Example: 2015Season to show
District list ¶
Headers
Content-Type: application/json
Body
districts: [
{
district: "sphelsinki",
district_name: "Helsinki"
},
{
district: "sphitasuomi",
district_name: "Itä-Suomi"
}
]
Get districtsGET/taso/rest/getDistricts
Field | Type | Description |
---|---|---|
district | string | ID of the distrct |
district_name | string | Name of the district |
Organiser list ¶
Headers
Content-Type: application/json
Body
organisers: [
{
organiser: "sphelsinki",
organiser_name: "Helsinki",
organiser_type: "region"
},
{
organiser: "kuusysi",
organiser_name: "FC Kuusysi",
organiser_type: "club"
}
]
Get organisersGET/taso/rest/getOrganisers
Competition list ¶
Headers
Content-Type: application/json
Body
[
{
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser": "spl",
"organiser_name": "Palloliitto",
"sport_id": "football",
},
{
"competition_id": "hki15",
"competition_name": "SPL Helsinki Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser": "splhelsinki",
"organiser_name": "Helsinki",
"sport_id": "football",
},
{
"competition_id": "spljp16",
"competition_name": "SPL Jalkapallo 2016",
"competition_status": "published",
"season_id": "2016",
"organiser": "spl",
"organiser_name": "Palloliitto",
"sport_id": "football",
},
]
Schema
competitions: [
{
competition_id: "Unique ID of the competition",
competition_name: "Name of the competition",
competition_status: "Publishing status competition [planned,published,archived]",
competition_start_date: "",
competition_end_date: "",
season_id: "Season that this competition belongs to, eg 2016,2016-17",
organiser: "Competition organiser ID (see getOrganisers)",
organiser_name: "Competition organiser name",
sport_id: "ID of the sport (see getSports)"
},
{
competition_id: "Unique ID of the competition",
competition_name: "Name of the competition",
competition_status: "Publishing status competition [planned,published,archived]",
competition_start_date: "",
competition_end_date: "",
season_id: "Season that this competition belongs to, eg 2016,2016-17",
organiser: "Competition organiser ID (see getOrganisers)",
organiser_name: "Competition organiser name",
sport_id: "ID of the sport (see getSports)"
},
{
competition_id: "Unique ID of the competition",
competition_name: "Name of the competition",
competition_status: "Publishing status competition [planned,published,archived]",
competition_start_date: "",
competition_end_date: "",
season_id: "Season that this competition belongs to, eg 2016,2016-17",
organiser: "Competition organiser ID (see getOrganisers)",
organiser_name: "Competition organiser name",
sport_id: "ID of the sport (see getSports)"
}
]
Get competitionsGET/taso/rest/getCompetitions{?api_key,current,season_id,organiser,official}
Field | Type | Description |
---|---|---|
competition_id | string | Unique ID of the competition |
competition_name | string | Name of the competition |
competition_status | string | Publishing status competition [planned,published,archived] |
competition_start_date | string | |
competition_end_date | string | |
season_id | string | Season that this competition belongs to, eg 2016,2016-17 |
organiser | string | Competition organiser ID (see getOrganisers) |
organiser_name | string | Competition organiser name |
sport_id | string | ID of the sport (see getSports) |
- api_key
string
(required)API key got from provider
- current
int
(optional) Default: 1 Example: 0Only list current competitions, not archived
- season_id
string
(optional) Example: 2015Only list selected season
- organiser
string
(optional) Example: splitaOnly list selected organiser
- official
int
(optional) Default: 0 Example: 1Only list official competitions, not private
Competition ¶
Headers
Content-Type: application/json
Body
[
{
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser" : "spl",
"organiser_name" : "Suomen Palloliitto",
"sport_id" : "football"
},
{
"competition_id": "hki15",
"competition_name": "SPL Helsinki Jalkapallo 2015",
"competition_status": "archived",
"season_id": "2015",
"organiser" : "splhelsinki",
"organiser_name" : "Helsingin piiri",
"sport_id" : "football"
},
{
"competition_id": "splfutsal1516",
"competition_name": "SPL Futsal 2015-16",
"competition_status": "published",
"season_id": "2015-16",
"organiser" : "spl",
"organiser_name" : "Suomen Palloliitto",
"sport_id" : "futsal"
},
]
Schema
{
"type": "array",
"competitions": {
"type": "object",
"properties": {
"competition_id": {
"description": "Unique id of the competition",
"type": "string"
},
"competition_name": {
"description": "Name of the competition",
"type": "string"
},
"competition_status": {
"description": "Publishing status competition",
"type": "string",
"values": "[planned,published,archived]"
},
"season_id": {
"description": "Season that this competition belongs to",
"type": "string",
"values": "eg. 2015, 2016-17"
},
"organiser": {
"description": "Competition organiser id",
"type": "string",
"values": "eg. spl,splhelsinki,spluusimaa,spltampere ..."
},
"organiser_name": {
"description": "Organiser name",
"type": "string",
"values": "Suomen Palloliitto, Helsingin piiri, Uudenmaan piiri, Tampereen piiri"
}
}
}
}
Get competitionGET/taso/rest/getCompetition{?api_key,competition_id}
- api_key
string
(required)API key got from provider
- competition_id
string
(optional) Example: spljp15Competition id, if not provided then returns common venues
Champions ¶
Headers
Content-Type: application/json
Body
{
"champions": [
{
"season_id": "2021",
"sport_id": "football",
"competition_id": "spljp21",
"competition_ńame": "SPL Jalkapallo 2021",
"category_id": "MSC",
"category_name": "Miesten Suomen Cup",
"club_id": "2963",
"team_id": "60756",
"team_name": "KuPS",
"champion_category_id": "MSC"
}
]
}
Get championsGET/taso/rest/getChampions
Field | Type | Description |
---|---|---|
season_id | string | |
sport_id | string | |
competition_id | string | |
competition_name | string | |
category_id | string | |
category_name | string | |
club_id | string | |
team_id | string | |
team_name | string | |
champion_category_id | string |
Category ¶
Category list ¶
Get a list of all categories in a competition or all competitions with the category. All_current, competition_id or category_id is required.
Headers
Content-Type: application/json
Body
{
"categories": [
{
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"category_id": "LC",
"category_name": "Liigacup",
"category_group": "1",
"category_group_name": "Miehet",
"category_link": "liigacup",
"authorized": "1"
}
]
}
Schema
[
{
"type": "array",
"categories": {
"type": "object",
"properties": {
"competition_id",
"competition_name",
"category_id",
"category_name",
"category_group",
"category_group_name",
"category_link",
"authorized"
}
}
}
]
Get categoriesGET/taso/rest/getCategories{?api_key,competition_id,category_id,organiser,all_current,authorized_only,competition_officiality}
- api_key
string
(required)API key got from provider
- competition_id
string
(optional) Example: spljp15Competition id
- category_id
string
(optional) Example: VLCategory id
- organiser
string
(optional) Example: splOrganiser id
- all_current
string
(optional) Example: 1List all current ie. not archived categories
- authorized_only
string
(optional) Example: 1Return only categories that this api_key has authorization for
- competition_officiality
string
(optional) Example: officialOnly list certain officiality [official, practice, hobby, tournament]
Category ¶
Get a single category.
Headers
Content-Type: application/json
Body
{
"category": {
"competition_id": "spljp15",
"category_id": "LC",
"category_name": "Liigacup",
"category_notice": "",
"category_notice_full" : "",
"teams": [
{
"team_id": "60987",
"team_name": "FC Inter"
},
{
"team_id": "60969",
"team_name": "FC Lahti"
}
],
"groups": [
{
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"category_id": "LC",
"category_name": "Liigacup",
"group_id": "1",
"group_name": "A",
"group_notice": "",
"group_notice_full" : ""
},
],
}
}
Headers
Content-Type: application/json
Body
{
"call": {
"error": "Category not found"
}
}
Get categoryGET/taso/rest/getCategory{?api_key,competition_id,category_id,matches}
- api_key
string
(required)API key got from provider
- competition_id
string
(required) Example: spljp15Competition id
- category_id
string
(required) Example: LCCategory id
- matches
string
(optional) Example: 11=list matches
Group ¶
Group ¶
Headers
Content-Type: application/json
Body
{
group": {
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"season_id": "2015",
"category_id": "LC",
"category_name": "Liigacup",
"group_type": "additional_group_stage",
"category_notice": "",
"category_notice_full" : "",
"group_id": "1",
"group_name": "A",
"group_notice": "",
"group_notice_full" : "",
"teams": [
{
"team_id": "60731",
"team_name": "HJK",
"current_standing": 1,
"starting_points": 0,
"points": 4,
"matches_played": 2,
"matches_won": 1,
"matches_tied": 1,
"matches_lost": 0
},
{
"team_id": "60972",
"team_name": "KTP",
"current_standing": 2,
"starting_points": 0,
"points": 1,
"matches_played": 1,
"matches_won": 0,
"matches_tied": 1,
"matches_lost": 0
},
{
"team_id": "60973",
"team_name": "RoPS",
"current_standing": 3,
"starting_points": 0,
"points": 0,
"matches_played": 1,
"matches_won": 0,
"matches_tied": 0,
"matches_lost": 1
}
],
live_standings: [
{
team_id: "60731",
team_name: "HJK",
current_standing: 1,
starting_points: 0,
points: 6,
matches_played: 4,
matches_won: 1,
matches_tied: 3,
matches_lost: 0,
goals_for: 6,
goals_against: 4,
points_home: 2,
matches_played_home: 2,
matches_won_home: 0,
matches_tied_home: 2,
matches_lost_home: 0,
goals_for_home: 4,
goals_against_home: 4,
points_away: 4,
matches_played_away: 2,
matches_won_away: 1,
matches_tied_away: 1,
matches_lost_away: 0,
goals_for_away: 2,
goals_against_away: 0
},
{
team_id: "60973",
team_name: "RoPS",
current_standing: 2,
starting_points: 0,
points: 5,
matches_played: 4,
matches_won: 1,
matches_tied: 2,
matches_lost: 1,
goals_for: 6,
goals_against: 6,
points_home: 3,
matches_played_home: 2,
matches_won_home: 1,
matches_tied_home: 0,
matches_lost_home: 1,
goals_for_home: 2,
goals_against_home: 2,
points_away: 2,
matches_played_away: 2,
matches_won_away: 0,
matches_tied_away: 2,
matches_lost_away: 0,
goals_for_away: 4,
goals_against_away: 4
},
{
team_id: "60972",
team_name: "FC KTP",
current_standing: 3,
starting_points: 0,
points: 3,
matches_played: 4,
matches_won: 0,
matches_tied: 3,
matches_lost: 1,
goals_for: 4,
goals_against: 6,
points_home: 2,
matches_played_home: 2,
matches_won_home: 0,
matches_tied_home: 2,
matches_lost_home: 0,
goals_for_home: 2,
goals_against_home: 2,
points_away: 1,
matches_played_away: 2,
matches_won_away: 0,
matches_tied_away: 1,
matches_lost_away: 1,
goals_for_away: 2,
goals_against_away: 4
}
],
player_statistics: [
{
player_id: "326097",
player_name: "Ibiyomi Michael",
first_name: "Michael",
last_name: "Ibiyomi",
team_id: "60973",
team_name: "RoPS",
goals: "3",
assists: "0",
warnings: "0",
suspensions: "0",
playing_time: "123"
},
{
player_id: "324046",
player_name: "Minkenen Valeri",
first_name: "Valeri",
last_name: "Minkenen",
team_id: "60972",
team_name: "FC KTP",
goals: "3",
assists: "0",
warnings: "1",
suspensions: "0",
playing_time: null
},
{
player_id: "105091",
player_name: "Zeneli Erfan",
first_name: "ERFAN",
last_name: "ZENELI",
team_id: "60731",
team_name: "HJK",
goals: "2",
assists: "0",
warnings: "0",
suspensions: "0",
playing_time: "2200"
},
]
}
Get groupGET/taso/rest/getGroup{?api_key,competition_id,category_id,group_id,matches}
Field | Type | Description |
---|
- api_key
string
(required)API key got from provider
- competition_id
string
(required) Example: spljp15Competition id
- category_id
string
(required) Example: LCCategory id
- group_id
string
(required) Example: 1Group id
- matches
string
(optional) Example: 11=list matches
Match ¶
Match list
[/taso/rest/getMatches?{api_key,season_id,competition_id,category_id,group_id,venue_id,joined_venues,venue_city,date,team_id,start_date,end_date,referee_id,club_id,details,category_group,match_number,match_status,match_id,home_away,find,per_page,page,page_size,page_number,official_only,competition_officiality,modified_since}]
-
Parameters
- api_key (required, string, ``) … API key got from provider
- season_id (optional, string,
2015
) … Seasion id, this or competition_id must be set - competition_id (optional, string,
spljp15
) … Competition id, this or season_id must be set - category_id (optional, string,
VL
) … Category id - group_id (optional, string,
1
) … Group id - venue_id (optional, string,
123
) … Venue id - joined_venues (optional, string
0
) … List matches in all joined venues (8v8 in 11v11 pitch) 1=yes (default), 0=no - venue_city (optional, string,
Espoo
) … Venue city, if date and start_date are empty then only matches from current day on are listed - team_id (optional, string,
123
) … Team id or multiple ids separated by comma eg. 123,456,789 - date (optional,string,
2015-05-25
) … Date yyyy-mm-dd or ‘today’,‘yesterday’,‘tomorrow’ - start_date (optional,string,
2015-05-25
) … First date to list matches yyyy-mm-dd or ‘today’,‘yesterday’,‘tomorrow’ - end_date (optional,string,
2015-05-25
) … Last date to list matches yyyy-mm-dd or ‘today’,‘yesterday’,‘tomorrow’ - referee_id (optional, string,
4567
) … Referee id - club_id (optional, string,
2585
) … Club id - details (optional, string,
0
) … 1 if you want match details, same as getMatch for each individual match - category_group (optional, string,
1
) … Category group eg. 1=Men, 2=Women, you can concatenate multiple values eg. 3,4 - match_number (optional, string,
1
) … Match number to retrieve, season_id or competition_id must also be set for this to work - match_status (optional, string,
Fixture
) … Status of the match [Fixture,Played] - match_id (optional, string,
1
) … Id of the match to retrieve, can have multiple comma separated values eg. 12345,23456 - home_away (optional, string,
home
) … Show only home or away matches [home,away], team_id or club_id must be set - find (optional, string,
Honka
) … Find matches where category, teams, clubs or venue match this string. Minimum length 2 characters. Returns at most 100 results, more results with page parameter. Only start_date, end_data, per_page and page parameters can be used with this. - per_page (optional, integer,
10
) … Use only with find parameter. Maximum number of results with return when used with find parameter. Maximum value 100, minimum value 1 - page (optional, integer,
2
) … Use only with find parameter. Page number to retrieve when find is used. Find parameter returns at most 100 matches, but this can be used to get more - page_size (optional, integer,
10
) … Maximum number of results. Minimum value 1 - page_number (optional, integer,
2
) … Page number to retrieve when paging is used - official_only (optional, integer
1
) … Retrieve only official matches (1) or all (0 or not set) - competition_officiality (optional,string
official
) … Retrieve only matches where competition officiality in this comma separated list: ‘official’,‘practice’,‘hobby’,‘tournament’ - modified_since (optional, string
2024-08-01 14:15:00
) … Retrieve only matches which have been modified since this time, match is deemed modified if date, time, venue, score, teams, or referees have been modified, other modifications such as players, events etc. do not update the modified time
-
Model
-
Headers
Content-Type: application/json
-
Body
{ "matches": [ { match_id: "276155", match_number: "273", match_report: "", competition_id: "spljp15", competition_name: "SPL Jalkapallo 2015", season_id: "2015", category_id: "LC", category_name: "Liigacup", category_group: "1", category_group_name: "Miehet", group_id: "1", group_name: "A", round_id: "5", round_name: "", round_team_id: "", round_club_id: "", round_club_name: "", date: "2015-02-13", time: "18:00:00", time_end: "20:00:00", time_zone: "EET", sunset: "16:43", club_A_id: "2942", team_A_id: "60973", team_A_name: "RoPS", team_A_home_venue_id: "", club_B_id: "2611", team_B_id: "60731", team_B_name: "HJK", status: "Played", extra_period_count: "", extra_period_min: "", fs_A: "0", fs_B: "2", hts_A: "0", hts_B: "0", es_A: "", es_B: "", ps_A: "", ps_B: "", venue_id: "2050", venue_name: "Heinäpää PH TN", venue_city_name: "Oulu", attendance: "562", referee_classification: "Liiga", referee_1_id: "10605", referee_1_name: "Antamo Dennis", referee_2_id: "", referee_2_name: "", assistant_referee_1_id: "2024", assistant_referee_1_name: "Nykänen Sami", assistant_referee_2_id: "42", assistant_referee_2_name: "Hautamäki Arttu", referee_observer_id: "", referee_observer_name: "", fourth_official_id: "", fourth_official_name: "", assistant_referee_observer_id: "", assistant_referee_observer_name: "", report_result: null, period_count: "2", period_min: "45", ps_count: "0", live_period: "2", live_time: "48:29", live_minutes: 90, live_timer_start: "2015-02-13 19:01:48", live_timer_start_time: "00:00:00", live_timer_on: 0, temperature: "", weather: "", stream_url: "", ticket_url: "", notice: "" } ] }
-
Schema
{ "type": "array", "matches": { "type": "object", "properties": { "status": { "type": "string", "description": "Planned/Fixture/Live/Break/Played/Canceled" }, "fs_A" : { "type": "string", "description": "Final score team A" }, "fs_B" : { "type": "string", "description": "Final score team B" }, "hts_A" : { "type": "string", "description": "Half time score team A" }, "hts_B" : { "type": "string", "description": "Half time score team B" }, "es_A" : { "type": "string", "description": "Extra time score team A" }, "es_B" : { "type": "string", "description": "Extra time score team B" }, "ps_A" : { "type": "string", "description": "Penalty shootout score team A" }, "ps_B" : { "type": "string", "description": "Penalty shootout time score team B" }, } } }
-
Get match list [GET]
Get list of matches based on different parameters
-
Response 200
[Match list][]
Match ¶
Headers
Content-Type: application/json
Body
{
call:{
method:"getMatch",
status:"ok"
},
match:{
match_id:"316137",
match_number:"5253",
match_report:"",
competition_id:"spljp15",
competition_name:"SPL Jalkapallo 2015",
organiser:"spl",
season_id:"2015",
category_id:"VL",
category_name:"Veikkausliiga",
category_group:"1",
category_group_name:"Miehet",
category_live:"1",
group_id:"1",
group_name:"1",
round_id:"3",
round_name:"",
round_team_id:"",
round_club_id:"",
round_club_name:"",
date:"2015-04-23",
time:"18:30:00",
time_end:"20:30:00",
time_zone:"",
sunset:"21:00",
club_A_id:"82",
team_A_id:"60808",
team_A_name:"HIFK",
team_A_home_venue_id:"",
club_B_id:"2611",
team_B_id:"60731",
team_B_name:"HJK",
status:"Played",
fs_A:"1",
fs_B:"1",
hts_A:"1",
hts_B:"1",
es_A:"",
es_B:"",
ps_A:"",
ps_B:"",
venue_id:"2497",
venue_name:"Telia 5G-Areena, Helsinki",
venue_city_name:"Helsinki",
venue_area_name:"Hki Töölö",
attendance:"10071",
referee_classification:"Liiga",
referee_1_id:"13353",
referee_1_name:"Gestranius Mattias",
referee_2_id:"",
referee_2_name:"",
assistant_referee_classification:"Liiga",
assistant_referee_1_id:"18",
assistant_referee_1_name:"Aravirta Jan-Peter",
assistant_referee_2_id:"13",
assistant_referee_2_name:"Alakare Mikko",
report_result:"0",
period_count:"2",
period_min:"45",
extra_period_count:"",
extra_period_min:"",
ps_count:"",
live_period:"",
live_time:"",
live_minutes:"",
live_timer_start:"",
live_timer_start_time:"",
live_timer_on:0,
temperature:"6",
weather:"Puolipilvistä",
stream_url:"",
ticket_url:"",
stream:"",
stream_media:"",
stream_media_name:"",
stream_img:"",
notice:"",
lineups:[
{
lineup_id:"10559478",
match_id:"316137",
team_id:"60808",
pos_id:"0",
player_id:"65519",
player_name:"Johansson Mika",
first_name:"Mika",
last_name:"Johansson",
shirt_number:"1",
shirt_name:"Johansson",
start:"0",
captain:"",
position:"",
position_fi:null,
position_order:"0",
playing_time_min:0
},
{
lineup_id:"10559492",
match_id:"316137",
team_id:"60808",
pos_id:"14",
player_id:"55278",
player_name:"Bäckman Jani",
first_name:"JANI",
last_name:"BÄCKMAN",
shirt_number:"17",
shirt_name:"BÄCKMAN",
start:"0",
captain:"",
position:"puolustaja",
position_fi:"puolustaja",
position_order:"0",
playing_time_min:0
},
],
goals:[
{
event_id:"1735599",
team_id:"60731",
player_id:"327274",
player_name:"Havenaar Mike",
time:"4:00",
time_min:"4",
wall_time:"00:00:00",
score_A:0,
score_B:1,
description:""
},
{
event_id:"1735595",
team_id:"60808",
player_id:"146181",
player_name:"Korhonen Joni",
time:"23:00",
time_min:"23",
wall_time:"00:00:00",
score_A:1,
score_B:1,
description:"rp"
}
],
bookings:[
{
team_id:"60808",
lineup_id:"10559508",
player_id:"385967",
player_name:"Halme Jukka",
time:"39:00",
time_min:"39",
wall_time:"00:00:00",
code:"varoitus",
description:"A"
},
{
team_id:"60808",
lineup_id:"10559510",
player_id:"75326",
player_name:"Lassas Fredrik",
time:"73:00",
time_min:"73",
wall_time:"00:00:00",
code:"varoitus",
description:"A"
},
{
team_id:"60808",
lineup_id:"10559512",
player_id:"66122",
player_name:"Jurvainen Otto-Pekka",
time:"79:00",
time_min:"79",
wall_time:"00:00:00",
code:"varoitus",
description:"A"
}
],
events:[
{
event_id:"1735470",
team_id:"0",
lineup_id:null,
player_id:null,
player_name:null,
time:"45+04:04",
time_min:"",
wall_time:"00:00:00",
period:"0",
code:"jaksoloppui",
description:""
},
{
event_id:"1735471",
team_id:"0",
lineup_id:null,
player_id:null,
player_name:null,
time:"45+04:04",
time_min:"",
wall_time:"00:00:00",
period:"0",
code:"otteluloppui",
description:""
},
{
event_id:"1735472",
team_id:"0",
lineup_id:null,
player_id:"",
player_name:"",
time:"0:00",
time_min:"0",
wall_time:"18:27:56",
period:"1",
code:"kelloseis",
description:""
},
{
event_id:"1735473",
team_id:"0",
lineup_id:null,
player_id:null,
player_name:null,
time:"0:00",
time_min:"0",
wall_time:"00:00:00",
period:"1",
code:"jaksoalkoi",
description:""
},
{
event_id:"1735474",
team_id:"0",
lineup_id:null,
player_id:"",
player_name:"",
time:"0:00",
time_min:"0",
wall_time:"18:32:39",
period:"1",
code:"kellokay",
description:""
},
],
awards:[
],
rights:[
]
}
}
Schema
{
"type": "object",
"match": {
"type": "object",
"properties": {
"match_id": {
"type": "string"
},
"match_number": {
"type": "string"
},
"competition_id": {
"type": "string"
},
"competition_name": {
"type": "string"
},
"category_id": {
"type": "string"
},
"category_name": {
"type": "string"
},
"group_id": {
"type": "string"
},
"group_name": {
"type": "string"
},
"round_id": {
"type": "string"
},
"round_name": {
"type": "string"
},
"date": {
"type": "string"
},
"time": {
"type": "string"
},
"sunset": {
"type": "string"
},
"club_A_id": {
"type": "string"
},
"team_A_id": {
"type": "string"
},
"team_A_name": {
"type": "string"
},
"team_A_home_venue_id": {
"type": "string"
},
"club_B_id": {
"type": "string"
},
"team_B_id": {
"type": "string"
},
"team_B_name": {
"type": "string"
},
"status": {
"type": "string",
"description" : "Planned,Cancelled,Fixture,Live,Break,Played"
},
"fs_A": {
"type": "string",
"description" : "Final score for team A"
},
"fs_B": {
"type": "string",
"description" : "Final score for team B"
},
"hts_A": {
"type": "string",
"description" : "Half time score for team A"
},
"hts_B": {
"type": "string",
"description" : "Half time score for team B"
},
"es_A": {
"type": "string",
"description" : "Extra time score for team A"
},
"es_B": {
"type": "string",
"description" : "Extra time score for team B"
},
"ps_A": {
"type": "string",
"description" : "Penalty shootout score for team A"
},
"ps_B": {
"type": "string",
"description" : "Penalty shootout score for team B"
},
"venue_id": {
"type": "string"
},
"venue_name": {
"type": "string"
},
"attendance": {
"type": "string"
},
"referee_1_id": {
"type": "string"
},
"referee_1_name": {
"type": "string"
},
"referee_2_id": {
"type": "string"
},
"referee_2_name": {
"type": "string"
},
"assistant_referee_1_id": {
"type": "string"
},
"assistant_referee_1_name": {
"type": "string"
},
"assistant_referee_2_id": {
"type": "string"
},
"assistant_referee_2_name": {
"type": "string"
},
"referee_observer_id": {
"type": "string"
},
"referee_observer_name": {
"type": "string"
},
"report_result": {
"type": "string"
},
"period_count": {
"type": "string",
"description" : "Number of periods in the match"
},
"period_min": {
"type": "string",
"description" : "Length of a period in minutes"
},
"extra_period_count": {
"type": "string",
"description" : "Number of possible extra time periods in the match"
},
"extra_period_min": {
"type": "string"
"description" : "Length of an extra time period in minutes"
},
"live_period": {
"type": "string",
"description" : "Current period when match is live"
},
"live_time": {
"type": "string",
"description" : "Current playing time hh:mm:ss when match is live"
},
"live_minutes": {
"type": "string",
"description" : "Current playing minute when match is live, can be eg 45+2 when playing overtime"
},
"live_timer_start": {
"type": "string"
},
"live_timer_start_time": {
"type": "string"
},
"live_timer_on": {
"type": "string"
},
"temperature": {
"type": "string"
},
"weather": {
"type": "string"
"description" : "Aurinkoista,Puolipilvistä,Pilvistä,Sadekuuroja,Tihkusadetta,Sadetta,Myrsky,Ukkosmyrsky,Lumi-/räntäsade"
},
"lineups": {
"type": "array",
"properties": {
"lineup_id": {
"type": "string"
},
"match_id": {
"type": "string"
},
"team_id": {
"type": "string"
},
"player_id": {
"type": "string"
},
"player_name": {
"type": "string"
},
"shirt_number": {
"type": "string"
},
"start": {
"type": "string"
},
"position": {
"type": "string"
},
"position_order": {
"type": "string"
},
"playing_time_min": {
"type": "int"
},
}
},
"events": {
"type": "array",
"properties": {
"event_id": {
"type": "string"
},
"team_id": {
"type": "string"
},
"lineup_id": {
"type": "string"
},
"player_id": {
"type": "string"
},
"player_name": {
"type": "string"
},
"time": {
"type": "string"
},
"code": {
"type": "string",
"description": "one of:vaihto, varoitus, ulosajo, maali, syotto, heitto, paitsio, kulmapotku, laukaus, laukausohi, laukaustolppa, torjunta, rike, vapaapotku"
},
"description": {
"type": "string",
"description": "+/- for substition or eg. reason code for booking"
},
}
}
}
}
}
Get matchGET/taso/rest/getMatch?{api_key,match_id}
Field | Type | Description |
---|---|---|
match_id | string | Unique ID of the match |
match_number | string | Public match number |
match_report | string | Link to the scanned match report |
aggregate_match | string | |
competition_id | string | |
competition_name | string | |
competition_logo | string | |
competition_status | string | |
competition_officiality | string | |
season_id | string | |
organiser | string | |
organiser_private | string | |
category_id | string | |
category_name | string | |
category_logo | string | |
category_group | string | |
category_group_name | string | |
category_group_name_en | string | |
category_live | string | |
calculate_points | string | |
season_order | string | |
group_id | string | |
group_name | string | |
group_type | string | |
round_id | string | |
round_name | string | |
round_date_begin | string | |
round_date_end | string | |
round_team_id | string | |
round_club_id | string | |
round_club_name | string | |
stage | string | |
stage_name | string | |
standings_name | string | |
date | string | |
time | string | |
reschedule | string | |
time_reservation_start | string | |
time_end | string | |
time_zone | string | |
time_zone_offset | string | |
sunset | string | |
club_A_id | string | |
club_A_name | string | |
club_A_abbrevation | string | |
club_A_www | string | |
club_A_crest | string | |
team_A_id | string | |
team_A_name | string | |
team_A_abbrevation | string | |
team_A_www | string | |
club_A_distance | string | |
team_A_home_venue_id | string | |
club_B_id | string | |
club_B_name | string | |
club_B_abbrevation | string | |
club_B_www | string | |
club_B_distance | string | |
club_B_crest | string | |
team_B_id | string | |
team_B_name | string | |
team_B_abbrevation | string | |
team_B_www | string | |
statistics_level | string | [concise=no event times,normal,extended=fouls, corners, off-sides, shots etc] |
status | string | [Fixture,Planned,Live,Break,Played,Canceled,Suspended,Abandoned,Reschedule] |
winner | string | [Home,Tie,Away,empty] |
winner_id | string | Id of the winning team or - if tied |
walkover | string | |
fs_A | string | Final score Team A |
fs_B | string | Final score Team B |
hts_A | string | Half-time score Team A |
hts_B | string | Half-time score Team B |
ns_A | string | Score after normal play Team A |
ns_B | string | Score after normal play Team B |
es_A | string | Total score after extra-time Team A |
es_B | string | Total score after extra-time Team B |
ps_A | string | Penalty shootout score Team A |
ps_B | string | Penalty shootout score Team B |
suspensions_A | string | |
suspensions_B | string | |
suspensions_officials_A | string | |
suspensions_officials_B | string | |
match_type | string | |
best_of_match | string | |
best_of_count | string | |
can_start_live | string | |
lineups_filled | string | |
best_of_sequence | string | |
track_scorers | string | |
track_assists | string | |
starting_players | string | |
sport_id | string | |
match_report_exists | string | |
p1_start_team | string | |
p1_start_time | string | |
p1_end_time | string | |
p1_duration | string | |
p1s_A | string | |
p1s_B | string | |
p1_winner | string | “”/A/B |
p2_start_team | string | |
p2_start_time | string | |
p2_end_time | string | |
p2_duration | string | |
p2s_A | string | |
p2s_B | string | |
p2_winner | string | “”/A/B |
p3_start_team | string | |
p3_start_time | string | |
p3_end_time | string | |
p3_duration | string | |
p3s_A | string | |
p3s_B | string | |
p3_winner | string | “”/A/B |
p4_start_team | string | |
p4_start_time | string | |
p4_end_time | string | |
p4_duration | string | |
p4s_A | string | |
p4s_B | string | |
p4_winner | string | “”/A/B |
p5_start_team | string | |
p5_start_time | string | |
p5_end_time | string | |
p5_duration | string | |
p5s_A | string | |
p5s_B | string | |
p5_winner | string | “”/A/B |
position_name | string | |
players_aside | string | |
serve_order | string | |
players_substitutes | string | |
substitutions | string | |
max_fouls | string | |
max_timeouts | string | |
referee_1_id | string | Id of the refereer |
referee_1_name | string | Name of referee |
referee_1_player_id | string | Player id of referee |
referee_2_id | string | Name of the 2nd referee observer |
referee_2_name | string | Name of the assistant referee observer |
referee_2_player_id | string | Player id of assistant referee observer |
assistant_referee_1_id | string | Id of the primary assistant referee |
assistant_referee_1_name | string | Name of the primary assistant referee |
assistant_referee_1_player_id | string | Player id of primary assistant referee |
assistant_referee_2_id | string | Id of the secondary assistant referee |
assistant_referee_2_name | string | Name of the secondary assistant referee |
assistant_referee_2_player_id | string | Player id of secondary assistant referee |
referee_1_join | string | ID of the joined match for referee assignment |
referee_2_join | string | ID of the joined match for referee assignment |
assistant_referee_1_join | string | ID of the joined match for referee assignment |
assistant_referee_2_join | string | ID of the joined match for referee assignment |
venue_id | string | |
venue_name | string | |
venue_name_competition | string | |
venue_city_name | string | |
venue_city_id | string | |
venue_area_id | string | |
venue_area_referee_club_id | string | |
venue_area_name | string | |
venue_location_id | string | |
venue_location_name | string | |
venue_suburb_name | string | |
attendance | string | |
referee_classification | string | |
report_result | string | |
playing_time_min | string | |
period_count | string | Number of periods |
win_period_count | string | Number of periods neede to win |
period_count_fixed | string | Always play fixed amount of periods (volleyball) |
period_min | string | Length of a single perid in minutes |
extra_period_count | string | Number of extra-time periods |
extra_period_min | string | Length of a single extra-time period in minutes |
ps_count | string | |
live_period | string | |
live_time | string | |
live_time_mmss | string | |
live_minutes | string | |
live_A | string | |
live_B | string | |
live_ps_A | string | |
live_ps_B | string | |
live_timeouts_A | string | |
live_timeouts_B | string | |
live_timeout_skip_A | string | |
live_timeout_skip_B | string | |
live_serve_team | string | |
live_fouls_A | string | |
live_fouls_B | string | |
live_timer_start | string | |
live_timer_start_time | string | |
live_timer_on | string | |
temperature | string | |
weather | string | |
stream_url | string | |
ticket_url | string | |
stream | string | |
stream_media | string | |
stream_media_name | string | |
stream_img | string | |
tv | string | |
notice | string | |
result_notice | string | |
stamp | string | |
assign_referee_1 | string | |
referee_1_distance | string | |
referee_fee | string | |
assign_referee_2 | string | |
referee_2_distance | string | |
assign_assistant_referee_1 | string | |
assistant_referee_1_distance | string | |
assign_assistant_referee_2 | string | |
assistant_referee_2_distance | string | |
assistant_referee_fee | string | |
referee_observer_id | string | ID of the assistant referee observer |
referee_observer_name | string | Name of the assistant referee observer |
assistant_referee_observer_id | string | ID of the assistant referee observer |
assistant_referee_observer_name | string | Name of the assistant referee observer |
assign_assistant_referee_observer | string | |
fourth_official_id | string | ID of the fourth official |
fourth_official_name | string | Name of the fourth official |
fourth_official_player_id | string | Player id of the fourth official |
assign_assistant_fourth_official | string | |
delegate_1_id | string | ID of the the match delegate 1 |
delegate_1_name | string | Name of the match delegate 1 |
assign_assistant_delegate_1 | string | |
delegate_2_id | string | ID of the the match delegate 2 |
delegate_2_name | string | Name of the the match delegate 2 |
assign_assistant_delegate_2 | string | |
internal_note | string | |
timestamp | string | |
venue_images | Array | |
match_parts | Array | |
aggregate_match_status | string | |
aggregate_match_score_A | string | |
aggregate_match_score_B | string | |
aggregate_match_score_parts | Array | |
best_of_needed | string | |
best_of_score_A | string | |
best_of_score_B | string | |
allow_referee_edit | string | |
allow_match_edit | string | |
lineups | Array | |
lineup_officials | Array | |
lineups_published | string | |
goals | Array | |
bookings | Array | |
events | Array | |
substitution_events | Array | |
awards | Array | |
rights | Array | |
kits | Array | Array |
period_lengths_sec | Array | |
match_length_sec | string |
- api_key
string
(required)API key got from provider
- match_id
int
(required) Example: 1Match ID
Score ¶
Get current score of one match. This result is never cached and can be polled frequently (max rate 1 per second)
Headers
Content-Type: application/json
Body
{
"score": {
"match_id": "1235937",
"match_number": "1476017",
"competition_id": "trejp19",
"category_id": "M6",
"team_A_id": "108165",
"team_A_name": "PYRY",
"team_B_id": "106814",
"team_B_name": "TKT/2",
"status": "Played",
"live_period": "-1",
"live_time": "00:00:00",
"live_time_mmss": "",
"live_timer_start": "0000-00-00 00:00:00",
"live_timer_start_time": "00:00:00",
"live_timer_on": "0",
"live_fouls_A": "",
"live_fouls_B": "",
"live_A": "12",
"live_B": "0",
"fs_A": "12",
"fs_B": "0",
"live_ps_A": "",
"live_ps_B": "",
"live_serve_team": null,
"hts_A": "5",
"hts_B": "0",
"es_A": "",
"es_B": "",
"ps_A": "",
"ps_B": "",
"p1s_A": "",
"p1s_B": "",
"p2s_A": "",
"p2s_B": "",
"p3s_A": "",
"p3s_B": "",
"p4s_A": "",
"p4s_B": "",
"p5s_A": "",
"p5s_B": ""
}
}
Get scoreGET/taso/rest/getScore?{api_key,match_id}
- api_key
string
(required)API key got from provider
- match_id
int
(required) Example: 1Match ID
Match count ¶
Headers
Content-Type: application/json
Body
{
call:{
method:"getMatchCount",
status:"ok"
}
dates: {
{
date: "2017-10-11",
match_count: "74"
},
{
date: "2017-10-12",
match_count: "54"
}
}
}
Get match countGET/taso/rest/getMatchCount?{api_key,match_id}
- api_key
string
(required)API key got from provider
- match_id
int
(required) Example: 1Match ID
Club ¶
Club list ¶
Headers
Content-Type: application/json
Body
{
"clubs : [
{
club_id: "3591",
name: "AC ALLIANSSI JUNIORIT",
abbrevation: "",
www: "",
district: "spluusimaa",
district_name: "Uusimaa",
crest: "",
sub_title: "",
region: "",
city_id: null,
city_name: null,
home_venue_id: null,
association_member: "1",
sports: [
{
sport_id: "football",
sport_name_fi: "Jalkapallo"
},
{
sport_id: "futsal",
sport_name_fi: "Futsal"
}
],
team_categories: [
{
fi: "Miehet"
},
{
fi: "Naiset"
}
]
}
}
}
Get clubsGET/taso/rest/getClubs{?api_key,district,season_id,competition_id,region,city_id,club_type,club_id,club_sport_id}
Field | Type | Description |
---|---|---|
club_id | string | |
name | string | |
abbrevation | string | |
www | string | |
crest | string | |
sub_title | string | |
region | string | |
city_id | string | |
city_name | string | |
home_venue_id | string | |
association_member | string | |
information | string | |
sports | string | |
team_categories | string |
- api_key
string
(required)API key got from provider
- district
string
(optional) Example: splhelsinkiDistrict code
- season_id
string
(optional) Example: 2023-2024Season ID
- competition_id
string
(optional) Example: league2023Competition ID
- region
string
(optional) Example: eteRegion ID
- city_id
string
(optional) Example: 1City ID
- club_type
string
(optional) Example: officialType of the club (official,hobby)
- club_id
string
(optional) Example: 1Club ID
- club_sport_id
string
(optional) Example: 1Club SportID
Club ¶
Headers
Content-Type: application/json
Body
{
"club": {
"club_id" : "2970",
"name" : "Pallokerho-37",
"abbrevation" : "Pallokerho-37",
"www" : "http://www.pk-37.fi",
"crest": "https://torneopal-sentinelsoftware.netdna-ssl.com//logo/palloliitto/2970x.png",
"sub_title" : "",
"district": "splitasuomi"
"teams": [
{
team_id: "60893",
team_name: "PK-37",
categories: [
{
competition_id: "spljp16",
competition_name: "SPL Jalkapallo 2016",
competition_season: "2016",
competition_active: "1",
category_id: "MRC",
category_name: "Regions Cup",
category_team_name: "PK-37"
},
{
competition_id: "itajalkapallo2016",
competition_name: "Itä-Suomi Jalkapallo 2016",
competition_season: "2016",
competition_active: "1",
category_id: "M3",
category_name: "Kolmonen",
category_team_name: "PK-37"
},
{
competition_id: "spljp15",
competition_name: "SPL Jalkapallo 2015",
competition_season: "2015",
competition_active: "0",
category_id: "MSC",
category_name: "Respect Suomen Cup",
category_team_name: "PK-37"
}
]
},
{
team_id: "108345",
team_name: "PK-37",
categories: [
{
competition_id: "itajalkapallo2016",
competition_name: "Itä-Suomi Jalkapallo 2016",
competition_season: "2016",
competition_active: "1",
category_id: "C15",
category_name: "C15 (-01) normaalikenttä",
category_team_name: "PK-37"
}
]
}
]
}
}
Get clubGET/taso/rest/getClub{?api_key,club_id,club_sport_id,season_id,competition_id}
- api_key
string
(required)API key got from provider
- club_id
int
(optional) Example: 2970Club ID. This parameter is not used with Club API Keys. Call will always return your own club when called with Club API Key.
- club_sport_id
int
(optional)Club SportID. This parameter is not used with Club API Keys. Call will always return your own club when called with Club API Key.
- season_id
string
(optional) Example: 2023-2024Season ID
- competition_id
string
(optional) Example: comp123Competition ID
Team ¶
Team ¶
Headers
Content-Type: application/json
Body
{
team: {
team_id: "92187",
team_name: "RIlves",
club_id: "61",
club_name: "RIlves",
home_venue_id: null,
home_venue_name: null,
players: [
{
player_id: "395382",
first_name: "Jere",
last_name: "Koponen",
shirt_number: "1",
shirt_name: "",
captain: "",
position: "maalivahti",
birthday: "1992-05-23",
birthyear: "1992",
height: "187",
weight: "81",
nationality: "FI",
matches: "0",
goals: "0",
assists: "0",
warnings: "0",
suspensions: "0",
playing_time: "0",
img_url: null
},
{
player_id: "80248",
first_name: "Niko",
last_name: "Markkula",
shirt_number: "2",
shirt_name: "",
captain: "",
position: "puolustaja",
birthday: "1990-06-27",
birthyear: "1990",
height: "178",
weight: "68",
nationality: "FI",
matches: "0",
goals: "0",
assists: "0",
warnings: "0",
suspensions: "0",
playing_time: "0",
img_url: null
},
],
"officials": [
{
"official_id": "14465",
"first_name": "Hannu",
"last_name": "Vento",
"official_role": "Huoltaja"
},
{
"official_id": "12651",
"first_name": "Matti",
"last_name": "Vikman",
"official_role": "Joukkueenjohtaja"
},
{
"official_id": "13410",
"first_name": "Juha",
"last_name": "Malinen",
"official_role": "Päävalmentaja"
},
{
"official_id": "14464",
"first_name": "Ossi",
"last_name": "Koskela",
"official_role": "Maalivahtivalmentaja"
}
],
categories: [
{
"competition_id": "spljp16",
"competition_name": "SPL Jalkapallo 2016",
"competition_season": "2016",
"competition_status": "published",
"category_id": "MRC",
"category_name": "Regions Cup",
"category_team_name": "PK-37"
},
{
"competition_id": "itajalkapallo2016",
"competition_name": "Itä-Suomi Jalkapallo 2016",
"competition_season": "2016",
"competition_status": "published",
"category_id": "M3",
"category_name": "Kolmonen",
"category_team_name": "PK-37"
}
]
}
}
Get teamGET/taso/rest/getTeam{?api_key,team_id,team_qrcode,competition_id,category_id}
Field | Type | Description |
---|
- api_key
string
(required)API key got from provider
- team_id
string
(optional)Team ID to get current roster
- team_qrcode
string
(optional)Team QR code to get authenticated information about the team (passes etc)
- competition_id
int
(optional) Example: spljp15Competition ID to get history data from match reports, if set then category_id is also required
- category_id
int
(optional) Example: VLCategory ID to get history data from match reports, required if competition_id is set. When this is set players will include all players who have played on this category, even if they’re not in current roster. If this is empty then players element will include current roster.
Teams ¶
Headers
Content-Type: application/json
Body
teams: [
{
"team_id": "66820",
"club_id": "70",
"team_name": "EPS",
"category_id": "MRC"
},
{
"team_id": "66827",
"club_id": "71",
"team_name": "HONKA",
"category_id": "MRC"
}
]
Get teamsGET/taso/rest/getTeams{?api_key,competition_id,category_id}
- api_key
string
(required)API key got from provider
- competition_id
int
(required) Example: spljp15Competition ID
- category_id
int
(optional) Example: MRCCategory ID
Player ¶
Player ¶
Headers
Content-Type: application/json
Body
{
"player": {
"player_id": "84102",
"first_name": "LASSI",
"last_name": "NURMOS",
"club_id": "1",
"club_name": "HJK",
"birthday": "1980-01-01",
"birthyear": "1980",
"nationality": "FI",
"img_url": "https://torneopal-sentinelsoftware.netdna-ssl.com/img/player/palloliitto/84102_7faaa184c46bb2efd4b2090c9a6c2c7c.jpg",
"teams": [
{
"team_id": "25094",
"team_name": "HJK",
"club_id": "1",
"club_name": "HJK",
"shirt_number": "4",
"captain": "C",
"position": "defender"
}
],
"matches": [
{
"match_id": "276155",
"match_number": "273",
"competition_id": "spljp15",
"competition_name": "SPL Jalkapallo 2015",
"category_id": "LC",
"category_name": "Liigacup",
"group_id": "1",
"group_name": "Liigacup",
"date": "2015-01-14",
"team_id": "25094",
"team_name": "HJK",
"player_goals": "1",
"player_warnings": "1",
"player_suspensions": "0"
}
]
}
}
Get playerGET/taso/rest/getPlayer{?api_key,player_id}
- api_key
string
(required)API key got from provider
- player_id
int
(required) Example: 60987Player ID
Players ¶
Headers
Content-Type: application/json
Body
{
"player": {
"player_id": "84102",
"first_name": "LASSI",
"last_name": "NURMOS",
"club_football_id": "1",
"club_football_name": "HJK",
"club_futsal_id": "999",
"club_futsal_name": "GFT",
"MA_id": "123456789",
"birthday": "1980-01-01",
"licence_football_type": "Amateur",
"licence_football_date": "2020-01-01",
"licence_futsal_type": "",
"licence_futsal_date": ""
}
}
Get playersGET/taso/rest/getPlayers{?api_key,club_id}
- api_key
string
(required)API key got from provider
- club_id
int
(required) Example: 162Club ID (club can only get their own players)
Sport ¶
Sport list ¶
Headers
Content-Type: application/json
Body
{
"call": {
"method": "getSports",
"status": "ok"
},
"sports": [
{
"sport_id": "football",
"sport_name": "Football",
"sport_name_fi": "Jalkapallo"
},
{
"sport_id": "futsal",
"sport_name": "Futsal",
"sport_name_fi": "Futsal"
},
{
"sport_id": "basketball",
"sport_name": "Basketball",
"sport_name_fi": "Koripallo"
},
{
"sport_id": "icehockey",
"sport_name": "Ice hockey",
"sport_name_fi": "Jääkiekko"
},
{
"sport_id": "handball",
"sport_name": "Handball",
"sport_name_fi": "Käsipallo"
}
{
"sport_id": "bandy",
"sport_name": "Bandy",
"sport_name_fi": "Jääpallo"
}
]
}
Schema
{
"call": {
"method": "getSports",
"status": "ok"
},
"sports": [
{
"sport_id": "ID of the sport",
"sport_name": "English name of the sport",
"sport_name_fi": "Finnish name of the sport"
}
]
}
Get sportsGET/taso/rest/getSports
Venue ¶
Venue list ¶
Headers
Content-Type: application/json
Body
[
venue_id: "2497",
venue_name: "Telia 5G Areena, Helsinki",
venue_address: "Urheilukatu 5",
venue_zipcode: "00250",
venue_city: "Helsinki",
venue_lat: "60.185854953551",
venue_lon: "24.923453144872",
venue_place: "",
venue_place_name: "",
venue_region: "101",
venue_region_name: "Hki Töölö",
venue_district: "splhelsinki",
venue_district_name: "Helsinki",
venue_length: "",
venue_width: "",
venue_height: "",
venue_surface: "football turf",
venue_surface_fi: "jalkapallonurmi",
venue_lights: "1",
venue_covered: "0",
venue_seats: "10770",
venue_warm: "",
venue_size: "11v11",
www: "http://www.5gareena.fi",
venue_images: [
{
url: "https://torneopal-sentinelsoftware.netdna-ssl.com//img/palloliitto/pitch/2497.jpg"
}
],
venue_properties: {
lights: "1",
covered: "0",
seats: "10770",
warm: "0"
},
venue_properties_fi: {
Valaistu: "1",
Katettu: "0",
Katsomo: "10770",
Lämmitys: "0"
}
]
Schema
{
"type": "array",
"venues": {
"type": "object",
"properties": {
"venue_id": {
"description": "Unique id (in the competition if competition_id was provided)",
"type": "string"
},
"venue_name": {
"description": "Name",
"type": "string"
},
"venue_address": {
"description": "Address",
"type": "string"
},
"venue_zipcode": {
"description": "Zip code",
"type": "string"
},
"venue_city": {
"description": "City",
"type": "string"
},
"venue_lat": {
"description": "Latitude",
"type": "string"
},
"venue_lon": {
"description": "Longitude",
"type": "string"
},
"venue_place": {
"description": "Common id for the venues in the same address",
"type": "string"
},
"venue_place_name": {
"description": "Common name for the venues in the same address",
"type": "string"
},
"venue_region": {
"description": "Region id",
"type": "string"
},
"venue_region_name": {
"description": "Region name",
"type": "string"
},
"venue_district": {
"description": "District id",
"type": "string"
},
"venue_district_name": {
"description": "District name",
"type": "string"
},
"venue_length": {
"description": "Length in meters",
"type": "string"
},
"venue_width": {
"description": "Width in meters",
"type": "string"
},
"venue_height": {
"description": "Height in meters",
"type": "string"
},
"venue_surface": {
"description": "Type of surface, one of [artificial turf,football turf,grass,gravel,plastic,wood,parquet,concrete]",
"type": "string"
},
"venue_lights": {
"description": "Lights 1=yes, 0=no, empty=don't know",
"type": "string"
},
"venue_covered": {
"description": "Is the pitch covered, 1=yes, 0=no, empty=don't know",
"type": "string"
},
"venue_seats": {
"description": "Number of seats, empty=don't know",
"type": "string"
},
"venue_warm": {
"description": "Is the covered pitch warm in winter 1=yes, 0=no, empty=don't know",
"type": "string"
}
}
}
}
Get venuesGET/taso/rest/getVenues{?api_key,competition_id,district}
- api_key
string
(required)API key got from provider
- competition_id
string
(optional) Example: spljp15Competition id, if not provided then returns common venues
- district
string
(optional) Example: splvaasaFilter by district
Venue region list ¶
Headers
Content-Type: application/json
Body
[
{
},
]
Schema
{
"type": "array",
"regions": {
"type": "object",
"properties": {
"venue_region_id": {
"description": "Unique id (in the competition if competition_id was provided)",
"type": "string"
},
"venue_region_name": {
"description": "Name",
"type": "string"
},
"venue_region_address": {
"description": "Address",
"type": "string"
},
"venue_region_zipcode": {
"description": "Zip code",
"type": "string"
},
"venue_region_city": {
"description": "City",
"type": "string"
},
"venue_region_lat": {
"description": "Latitude",
"type": "string"
},
"venue_region_lon": {
"description": "Longitude",
"type": "string"
},
}
}
}
Get venue regionsGET/taso/rest/getVenueRegions{?api_key,competition_id,district}
- api_key
string
(required)API key got from provider
- competition_id
string
(optional) Example: spljp15Competition id, if not provided then returns common venues
- district
string
(optional) Example: splvaasaFilter by district
Vacancies ¶
Headers
Content-Type: application/json
Get vacanciesGET/taso/rest/getVacancies{?api_key,club_id,team_id}
Field | Type | Description |
---|
- api_key
string
(required)API key got from provider
- club_id
int
(optional) Example: 1Club ID to get vacancies from
- team_id
int
(optional) Example: 1234Team ID to get vacancies from
Generated by aglio on 05 Sep 2024