> Matches Results

The API has only a mandatory parameter league, where you specify the league name you are interested in. Ammisisble values are premierleague, laliga, serie-a, bundesliga,ligue1, eredivisie, liganos, russianpremierleague, championsleague and europaleague.

Without submitting any other parameter, you get all the matches for the day (if there isn’t any match for the day you will get a 500 server error)

-submitting the parameter date, to retrieve the matches for that date (in the format mmddyyyy)

-submitting the parameter team1, to retrieve the matches that the team has played at home (together with team2 return that very match)

-submitting the parameter team2, to retrieve the matches that the team has played away (together with team1 return that very match)

-submitting the parameter matchday, to retrieve the matches for that round

If matches are already played, the API will give you data about red cards number if any, referee , final and first half scores too, otherwise only the matches that will be played.
here it is an example response for a call with a match day already played (matchday=1)

 {"matches":[
   {"team1":{"teamScore":1,"teamName":"Manchester United","firstHalfScore":1},
     "team2":{"teamScore":0,"teamName":"Tottenham","firstHalfScore":0},
     "time":"FT","referee":"Jonathan Moss","when":"Saturday, Aug 8 2015"},
   {"team1":{"teamScore":0,"teamName":"Bournemouth","firstHalfScore":0},
     "team2":{"teamScore":1,"teamName":"Aston Villa","firstHalfScore":0},
     "time":"FT","referee":"Mark Clattenburg","when":"Saturday, Aug 8 2015"},
   .....
   .....
 ]}

and here it is an example response for a call wit a match day not yet played (matchday=20)

 {"matches":[
    {"team1":{"teamName":"Watford"},"team2":{"teamName":"Manchester City"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"West Bromwich Albion"},"team2":{"teamName":"Stoke"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"West Ham"},"team2":{"teamName":"Liverpool"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Arsenal"},"team2":{"teamName":"Newcastle United"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Crystal Palace"},"team2":{"teamName":"Chelsea"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Everton"},"team2":{"teamName":"Tottenham"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Leicester"},"team2":{"teamName":"Bournemouth"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Manchester United"},"team2":{"teamName":"Swansea"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Norwich"},"team2":{"teamName":"Southampton"},"when":"Saturday, Jan 2 2016"},
    {"team1":{"teamName":"Sunderland"},"team2":{"teamName":"Aston Villa"},"when":"Saturday, Jan 2 2016"}
 ]}

Take in mind that this API returns only final results ("time":"FT") or not already played matches, and the final ones only after a while the matches are really finished (usually always within 24 hours).

You can get historical results either setting the optional parameter season .