Taso API

API Endpoint

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

GET /taso/rest/getSeasons?api_key=&sport_id=football
Responses200
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 seasons
GET/taso/rest/getSeasons{?api_key,sport_id}

Field Type Description
season_id string
season_description string
sport_id string
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

sport_id
string (optional) Example: football

Only list current seasons a specific sport (see getSports)


Season

GET /taso/rest/getSeason?season_id=2015
Responses200
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 season
GET/taso/rest/getSeason{?season_id}

Field Type Description
URI Parameters
HideShow
season_id
string (required) Example: 2015

Season to show


District list

GET /taso/rest/getDistricts
Responses200
Headers
Content-Type: application/json
Body
districts: [
    {
        district: "sphelsinki",
        district_name: "Helsinki"
    },
    {
        district: "sphitasuomi",
        district_name: "Itä-Suomi"
    }
]

Get districts
GET/taso/rest/getDistricts

Field Type Description
district string ID of the distrct
district_name string Name of the district

Organiser list

GET /taso/rest/getOrganisers
Responses200
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 organisers
GET/taso/rest/getOrganisers


Competition list

GET /taso/rest/getCompetitions?api_key=&current=0&season_id=2015&organiser=splita&official=1
Responses200
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 competitions
GET/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)
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

current
int (optional) Default: 1 Example: 0

Only list current competitions, not archived

season_id
string (optional) Example: 2015

Only list selected season

organiser
string (optional) Example: splita

Only list selected organiser

official
int (optional) Default: 0 Example: 1

Only list official competitions, not private


Competition

GET /taso/rest/getCompetition?api_key=&competition_id=spljp15
Responses200
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 competition
GET/taso/rest/getCompetition{?api_key,competition_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (optional) Example: spljp15

Competition id, if not provided then returns common venues


Champions

GET /taso/rest/getChampions
Responses200
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 champions
GET/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.

GET /taso/rest/getCategories?api_key=&competition_id=spljp15&category_id=VL&organiser=spl&all_current=1&authorized_only=1&competition_officiality=official
Responses200
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 categories
GET/taso/rest/getCategories{?api_key,competition_id,category_id,organiser,all_current,authorized_only,competition_officiality}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (optional) Example: spljp15

Competition id

category_id
string (optional) Example: VL

Category id

organiser
string (optional) Example: spl

Organiser id

all_current
string (optional) Example: 1

List all current ie. not archived categories

authorized_only
string (optional) Example: 1

Return only categories that this api_key has authorization for

competition_officiality
string (optional) Example: official

Only list certain officiality [official, practice, hobby, tournament]


Category

Get a single category.

GET /taso/rest/getCategory?api_key=&competition_id=spljp15&category_id=LC&matches=1
Responses200404
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 category
GET/taso/rest/getCategory{?api_key,competition_id,category_id,matches}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (required) Example: spljp15

Competition id

category_id
string (required) Example: LC

Category id

matches
string (optional) Example: 1

1=list matches


Group

Group

GET /taso/rest/getGroup?api_key=&competition_id=spljp15&category_id=LC&group_id=1&matches=1
Responses200
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 group
GET/taso/rest/getGroup{?api_key,competition_id,category_id,group_id,matches}

Field Type Description
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (required) Example: spljp15

Competition id

category_id
string (required) Example: LC

Category id

group_id
string (required) Example: 1

Group id

matches
string (optional) Example: 1

1=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

GET /taso/rest/getMatch?api_key&1
Responses200
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 match
GET/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
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

match_id
int (required) Example: 1

Match ID


Score

Get current score of one match. This result is never cached and can be polled frequently (max rate 1 per second)

GET /taso/rest/getScore?api_key&1
Responses200
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 score
GET/taso/rest/getScore?{api_key,match_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

match_id
int (required) Example: 1

Match ID


Match count

GET /taso/rest/getMatchCount?api_key&1
Responses200
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 count
GET/taso/rest/getMatchCount?{api_key,match_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

match_id
int (required) Example: 1

Match ID


Club

Club list

GET /taso/rest/getClubs?api_key=&district=splhelsinki&season_id=2023-2024&competition_id=league2023&region=ete&city_id=1&club_type=official&club_id=1&club_sport_id=1
Responses200
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 clubs
GET/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
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

district
string (optional) Example: splhelsinki

District code

season_id
string (optional) Example: 2023-2024

Season ID

competition_id
string (optional) Example: league2023

Competition ID

region
string (optional) Example: ete

Region ID

city_id
string (optional) Example: 1

City ID

club_type
string (optional) Example: official

Type of the club (official,hobby)

club_id
string (optional) Example: 1

Club ID

club_sport_id
string (optional) Example: 1

Club SportID


Club

GET /taso/rest/getClub?api_key=&club_id=2970&club_sport_id=&season_id=2023-2024&competition_id=comp123
Responses200
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 club
GET/taso/rest/getClub{?api_key,club_id,club_sport_id,season_id,competition_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

club_id
int (optional) Example: 2970

Club 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-2024

Season ID

competition_id
string (optional) Example: comp123

Competition ID


Team

Team

GET /taso/rest/getTeam?api_key=&team_id=&team_qrcode=&competition_id=spljp15&category_id=VL
Responses200
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 team
GET/taso/rest/getTeam{?api_key,team_id,team_qrcode,competition_id,category_id}

Field Type Description
URI Parameters
HideShow
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: spljp15

Competition ID to get history data from match reports, if set then category_id is also required

category_id
int (optional) Example: VL

Category 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

GET /taso/rest/getTeams?api_key=&competition_id=spljp15&category_id=MRC
Responses200
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 teams
GET/taso/rest/getTeams{?api_key,competition_id,category_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
int (required) Example: spljp15

Competition ID

category_id
int (optional) Example: MRC

Category ID


Player

Player

GET /taso/rest/getPlayer?api_key=&player_id=60987
Responses200
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 player
GET/taso/rest/getPlayer{?api_key,player_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

player_id
int (required) Example: 60987

Player ID


Players

GET /taso/rest/getPlayers?api_key=&club_id=162
Responses200
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 players
GET/taso/rest/getPlayers{?api_key,club_id}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

club_id
int (required) Example: 162

Club ID (club can only get their own players)


Sport

Sport list

GET /taso/rest/getSports
Responses200
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 sports
GET/taso/rest/getSports


Venue

Venue list

GET /taso/rest/getVenues?api_key=&competition_id=spljp15&district=splvaasa
Responses200
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 venues
GET/taso/rest/getVenues{?api_key,competition_id,district}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (optional) Example: spljp15

Competition id, if not provided then returns common venues

district
string (optional) Example: splvaasa

Filter by district


Venue region list

GET /taso/rest/getVenueRegions?api_key=&competition_id=spljp15&district=splvaasa
Responses200
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 regions
GET/taso/rest/getVenueRegions{?api_key,competition_id,district}

URI Parameters
HideShow
api_key
string (required) 

API key got from provider

competition_id
string (optional) Example: spljp15

Competition id, if not provided then returns common venues

district
string (optional) Example: splvaasa

Filter by district


Vacancies

GET /taso/rest/getVacancies?api_key=&club_id=1&team_id=1234
Responses200
Headers
Content-Type: application/json

Get vacancies
GET/taso/rest/getVacancies{?api_key,club_id,team_id}

Field Type Description
URI Parameters
HideShow
api_key
string (required) 

API key got from provider

club_id
int (optional) Example: 1

Club ID to get vacancies from

team_id
int (optional) Example: 1234

Team ID to get vacancies from


Generated by aglio on 05 Sep 2024