Start Plans Docs Litzscore.com Love My Apps
Get Started Usage Limits Concept Free APIs API Coverage Spider API Coverage Auth API Match API Ball By Ball API Recent Matches API Recent Seasons API Schedule API Season API Season Stats API Season Points API Season Player Stats API Over Summary API News Aggregation API Card Objects ICC Teams League Teams Properties Team Object Player Object Season Object Innings Object
  • Answer
  • Answer Metrics
  • Player Stats
  • Team Stats
  • Player Vs Team Stats
  • Player Timeline
  • Team Timeline
  • Guide API's Spider API's Reference

    Recent matches API

    Recent matches API provides list of all world wide recent matches . It also provides the recent matches for specific season. Usually it will give 3 completed matches, 3 upcoming matches and all live matches.

    Notice: All the responses are GZIP encoded. That is "Content-Encoding: gzip". Its effective from March 29, 2015.

    Request


    • Path: /rest/v2/recent_matches/
    • Path (for season based): /rest/v2/season/{SEASON_KEY}/recent_matches/
    • Method: GET
    • Params:
      • access_token - Required.
      • card_type - Optional. Default to micro_card. Accepted values are micro_card & summary_card. And full_card is not supported. Ref Card type

    Response


    Read more about card here.

    Example with Micro Card


    $ GET /rest/v2/recent_matches/?access_token=ACCESSTOKEN

    {"status":true,"version":"2.0.3","status_code":200,"expires":"1453994940.0","Etag":null,"cache_key":"recent_matches|micro_card","data":{"card_type":"micro_card","cards":[{"status":"notstarted","related_name":"2nd T20 Match","expires":"1454005730.0","name":"Australia vs India","short_name":"AUS vs IND","title":"Australia vs India - 2nd T20 Match - Australia vs India 2016","season":{"name":"Australia vs India 2016"},"format":"t20","venue":"Melbourne Cricket Ground, Australia","teams":{"a":{"name":"Australia","key":"aus"},"b":{"name":"India","key":"ind"}},"winner_team":null,"key":"ausind_2016_t20_02","msgs":{"others":[]},"ref":"http://www.litzscore.com/series/ausind_2016/ausind_2016_t20_02/","start_date":{"iso":"2016-01-29T08:40+00:00"}},{"status":"notstarted","related_name":"3rd ODI Match","expires":"1454005730.0","name":"New Zealand vs Pakistan","short_name":"NZ vs PAK","title":"New Zealand vs Pakistan - 3rd ODI Match - New Zealand vs Pakistan 2016","season":{"name":"New Zealand vs Pakistan 2016"},"format":"one-day","venue":"Eden Park, Auckland, New Zealand","teams":{"a":{"name":"New Zealand","key":"nz"},"b":{"name":"Pakistan","key":"pak"}},"winner_team":null,"key":"nzpak_2016_one-day_03","msgs":{"others":[]},"ref":"http://www.litzscore.com/series/nzpak_2016/nzpak_2016_one-day_03/","start_date":{"iso":"2016-01-30T22:00+00:00"}},{"status":"started","related_name":"6th Qualifying Match","expires":"1457958250.0","name":"Team X vs Team Y","short_name":"TX vs TY","title":"Team X vs Team Y - 6th Qualifying Match - DEV SEASON 2014","season":{"name":"DEV SEASON 2014"},"format":"t20","venue":"India","teams":{"a":{"name":"Team X","key":"tx"},"b":{"name":"Team Y","key":"ty"}},"winner_team":"","key":"dev_season_2014_q6","msgs":{"match_comments":"Reduced to 15 overs on both sides.","others":[]},"cache_key":"match|dev_season_2014_q6|micro_card","ref":"http://www.litzscore.com/series/dev_season_2014/dev_season_2014_q6/","start_date":{"iso":"2014-09-24T00:00+00:00"}},{"status":"completed","related_name":"2nd ODI Match","expires":"1454005730.0","name":"New Zealand vs Pakistan","short_name":"NZ vs PAK","title":"New Zealand vs Pakistan - 2nd ODI Match - New Zealand vs Pakistan 2016","season":{"name":"New Zealand vs Pakistan 2016"},"format":"one-day","venue":"McLean Park, Napier, New Zealand","approx_completed_ts":1453959016,"teams":{"a":{"name":"New Zealand","key":"nz"},"b":{"name":"Pakistan","key":"pak"}},"winner_team":"","key":"nzpak_2016_one-day_02","msgs":{"info":"Match abandoned without a ball bowled","completed":"Match abandoned without a ball bowled","others":[]},"ref":"http://www.litzscore.com/series/nzpak_2016/nzpak_2016_one-day_02/","start_date":{"iso":"2016-01-28T01:00+00:00"}},{"status":"completed","related_name":"1st T20 Match","expires":"1454005730.0","name":"Australia vs India","short_name":"AUS vs IND","title":"Australia vs India - 1st T20 Match - Australia vs India 2016","season":{"name":"Australia vs India 2016"},"format":"t20","venue":"Adelaide Oval, Australia","approx_completed_ts":1453809879,"teams":{"a":{"name":"Australia","key":"aus"},"b":{"name":"India","key":"ind"}},"winner_team":"b","key":"ausind_2016_t20_01","msgs":{"info":"India won by 37 runs.","completed":"India won by 37 runs.","others":[]},"ref":"http://www.litzscore.com/series/ausind_2016/ausind_2016_t20_01/","start_date":{"iso":"2016-01-26T08:40+00:00"}},{"status":"completed","related_name":"4th Test Match","expires":"1454005730.0","name":"South Africa vs England","short_name":"RSA vs ENG","title":"South Africa vs England - 4th Test Match - South Africa vs England 2015","season":{"name":"South Africa vs England 2015"},"format":"test","venue":"SuperSport Park, Centurion, South Africa","approx_completed_ts":1453799302,"teams":{"a":{"name":"South Africa","key":"rsa"},"b":{"name":"England","key":"eng"}},"winner_team":"a","key":"rsaeng_2015_test_04","msgs":{"info":"South Africa won by 280 runs.","completed":"South Africa won by 280 runs.","others":[]},"ref":"http://www.litzscore.com/series/rsaeng_2015/rsaeng_2015_test_04/","start_date":{"iso":"2016-01-22T08:30+00:00"}}],"intelligent_order":["nzpak_2016_one-day_02","ausind_2016_t20_02","nzpak_2016_one-day_03","ausind_2016_t20_01","ausind_2016_t20_03","rsaeng_2015_test_04"]}}

    Example with Summary Card


    $ GET /rest/v2/recent_matches/?access_token=ACCESSTOKEN&card_type=summary_card

    {"status":true,"version":"2.0.3","status_code":200,"expires":"1457959252.0","Etag":null,"cache_key":"recent_matches|summary_card","data":{"card_type":"summary_card","cards":[{"related_name":"13th Match - Group 2","msgs":{"others":[]},"toss":{},"winner_team":null,"winning_ratio":{"a":null,"b":null},"innings":{},"title":"India vs New Zealand - 13th Match - Group 2 - ICC World Cup Twenty20 2016","dl_applied":false,"start_date":{"timestamp":1458050400,"iso":"2016-03-15T14:00+00:00","str":"15th Mar 2016 14:00 GMT"},"status":"notstarted","man_of_match":null,"description":"On 15 March 2016, India playing against New Zealand in Vidarbha Cricket Association Stadium, Nagpur, India. Match (India vs New Zealand - 13th Match - Group 2 - ICC World Cup Twenty20 2016) will begin at 14:00 GMT.","short_name":"IND vs NZ","format":"t20","season":{"name":"ICC World Cup Twenty20 2016","key":"icc_wc_t20_2016"},"expires":"1457970042.0","status_overview":"scheduled","match_overs":20,"key":"icc_wc_t20_2016_g13","now":{"bowling_team":null,"nonstriker":null,"runs_str":null,"batting_team":null,"innings":"1","req":{},"runs":null,"striker":null,"break":{"duration":null,"reason":null},"bowler":null,"next_ball":{},"run_rate":null,"recent_overs_str":[],"balls":null},"day":null,"name":"India vs New Zealand","ref":"http://www.litzscore.com/series/icc_wc_t20_2016/icc_wc_t20_2016_g13/","venue":"Vidarbha Cricket Association Stadium, Nagpur, India","teams":{"a":{"short_name":"IND","name":"India","key":"ind"},"b":{"short_name":"NZ","name":"New Zealand","key":"nz"}},"players":{},"data_review_checkpoint":"","first_batting":null,"result_by":null},{"related_name":"14th Match - Group 2","msgs":{"others":[]},"toss":{},"winner_team":null,"winning_ratio":{"a":null,"b":null},"innings":{},"title":"Pakistan vs Bangladesh - 14th Match - Group 2 - ICC World Cup Twenty20 2016","dl_applied":false,"start_date":{"timestamp":1458120600,"iso":"2016-03-16T09:30+00:00","str":"16th Mar 2016 09:30 GMT"},"status":"notstarted","man_of_match":null,"description":"On 16 March 2016, Pakistan playing against Bangladesh in Eden Gardens, Kolkata, India. Match (Pakistan vs Bangladesh - 14th Match - Group 2 - ICC World Cup Twenty20 2016) will begin at 09:30 GMT.","short_name":"PAK vs BAN","format":"t20","season":{"name":"ICC World Cup Twenty20 2016","key":"icc_wc_t20_2016"},"expires":"1457970042.0","status_overview":"scheduled","match_overs":20,"key":"icc_wc_t20_2016_g14","now":{"bowling_team":null,"nonstriker":null,"runs_str":null,"batting_team":null,"innings":"1","req":{},"runs":null,"striker":null,"break":{"duration":null,"reason":null},"bowler":null,"next_ball":{},"run_rate":null,"recent_overs_str":[],"balls":null},"day":null,"name":"Pakistan vs Bangladesh","ref":"http://www.litzscore.com/series/icc_wc_t20_2016/icc_wc_t20_2016_g14/","venue":"Eden Gardens, Kolkata, India","teams":{"a":{"short_name":"PAK","name":"Pakistan","key":"pak"},"b":{"short_name":"BAN","name":"Bangladesh","key":"ban"}},"players":{},"data_review_checkpoint":"","first_batting":null,"result_by":null},{"related_name":"6th Qualifying Match","msgs":{"match_comments":"Reduced to 15 overs on both sides.","others":[]},"toss":{"decision":"bat","won":"a","str":"Team X won the toss and chose to bat first"},"winner_team":"","winning_ratio":{"a":100,"b":0},"innings":{"b_1":{"batting_order":[],"runs":0,"balls":0,"wickets":0,"wide":0,"overs":"0.0","fours":0,"run_str":"0/0 in 0.0","wicket_order":[],"overs_summary":[],"sixes":0,"noball":0,"dotballs":0,"extras":0,"key":"b_1","bowling_order":["player_y11","player_y10"],"legbye":0,"bye":0,"run_rate":0,"fall_of_wickets":[],"partnerships":[]},"a_1":{"runs":12,"balls":8,"wickets":0,"wide":0,"overs":"1.2","fours":1,"run_str":"12/0 in 1.2","sixes":1,"noball":0,"dotballs":4,"extras":0,"key":"a_1","legbye":0,"bye":0,"run_rate":"9.00"}},"title":"Team X vs Team Y - 6th Qualifying Match - DEV SEASON 2014","dl_applied":true,"start_date":{"timestamp":1411516800,"iso":"2014-09-24T00:00+00:00","str":"24th Sep 2014 00:00 GMT"},"status":"started","man_of_match":"","description":"On 24 September 2014, Team X playing against Team Y in India. Match (Team X vs Team Y - 6th Qualifying Match - DEV SEASON 2014) will begin at 00:00 GMT.","short_name":"TX vs TY","format":"t20","season":{"name":"DEV SEASON 2014","key":"dev_season_2014"},"expires":"1457959292.0","status_overview":"in_play","match_overs":15,"key":"dev_season_2014_q6","now":{"bowling_team":"b","nonstriker":"player_x1","runs_str":"12/0 in 1.2","batting_team":"a","req":{},"innings":"1","bowler":"player_y10","runs":12,"striker":"player_x2","break":{"duration":"","reason":""},"balls":8,"next_ball":{"nonstriker":"player_x1","bowler":"player_y10","over":2,"striker":"player_x2","ball":3,"over_str":"1.3"},"wicket":0,"run_rate":"9.00","recent_overs_str":[[2,["r1","b4"]],[1,["r0","r0","b6","r0","r0","r1"]]]},"day":"","name":"Team X vs Team Y","ref":"http://www.litzscore.com/series/dev_season_2014/dev_season_2014_q6/","venue":"India","teams":{"a":{"short_name":"TX","name":"Team X","key":"tx"},"b":{"short_name":"TY","name":"Team Y","key":"ty"}},"players":{"player_x2":{"fullname":"Player x2","name":"Player x2","match":{"innings":{"1":{"fielding":{},"batting":{"dots":0,"sixes":0,"runs":4,"balls":1,"fours":1,"strike_rate":400.0},"bowling":{}}}},"identified_roles":{"keeper":null,"batsman":null,"bowler":null}},"player_x1":{"fullname":"Player x1","name":"Player x1","match":{"innings":{"1":{"fielding":{},"batting":{"dots":4,"sixes":1,"runs":8,"balls":7,"fours":0,"strike_rate":114.29},"bowling":{}}}},"identified_roles":{"keeper":null,"batsman":null,"bowler":null}},"player_y10":{"fullname":"Player y10","name":"Player y10","match":{"innings":{"1":{"fielding":{},"batting":{},"bowling":{"runs":5,"balls":2,"maiden_overs":0,"wickets":0,"extras":0,"overs":"0.2","economy":15.0}}}},"identified_roles":{"keeper":null,"batsman":null,"bowler":null}}},"data_review_checkpoint":"","first_batting":"a","result_by":"","cache_key":"match|dev_season_2014_q6|summary_card"},{"related_name":"12th Match - Group A","msgs":{"info":"Bangladesh won by 54 runs (D/L method)","completed":"Bangladesh won by 54 runs (D/L method)","others":[]},"toss":{"decision":"bowl","won":"b","str":"Oman won the toss and chose to bowl first"},"approx_completed_ts":1457892330,"winner_team":"a","winning_ratio":{"a":null,"b":null},"innings":{"b_1":{"wide":4,"runs":65,"balls":72,"sixes":1,"overs":"12.0","fours":7,"run_str":"65/9 in 12.0","wickets":9,"noball":0,"dotballs":38,"extras":6,"key":"b_1","legbye":2,"bye":0,"run_rate":"5.42"},"a_1":{"wide":3,"runs":180,"balls":120,"sixes":7,"overs":"20.0","fours":19,"run_str":"180/2 in 20.0","wickets":2,"noball":0,"dotballs":42,"extras":4,"key":"a_1","legbye":1,"bye":0,"run_rate":"9.00"}},"title":"Bangladesh vs Oman - 12th Match - Group A - ICC World Cup Twenty20 2016","dl_applied":true,"start_date":{"timestamp":1457877600,"iso":"2016-03-13T14:00+00:00","str":"13th Mar 2016 14:00 GMT"},"status":"completed","man_of_match":"t_iqbal","description":"Bangladesh won by 54 runs (D/L method) Bangladesh scored 180/2 in 20.0 and Oman scored 65/9 in 12.0. Tamim Iqbal played good and he is man of the match.","short_name":"BAN vs OMN","format":"t20","season":{"name":"ICC World Cup Twenty20 2016","key":"icc_wc_t20_2016"},"expires":"1457970042.0","status_overview":"result","match_overs":12,"key":"icc_wc_t20_2016_g12","now":{"bowling_team":"a","nonstriker":null,"runs_str":"65/9 in 12.0","batting_team":"b","innings":"1","req":{"runs_str":"","balls":0,"runs_rate":0.0,"runs":0,"target_runs":120,"target_balls":72},"runs":65,"striker":null,"break":{"duration":"","reason":""},"bowler":null,"next_ball":{},"wicket":9,"run_rate":"5.42","recent_overs_str":[[12,["e1,wd","r1","r0","r1","r1","w","r1"]],[11,["w","r0","w","r1","r0","r0"]],[10,["r1","b4","w","e1,lb","r1","r1"]]],"balls":72},"day":"","name":"Bangladesh vs Oman","ref":"http://www.litzscore.com/series/icc_wc_t20_2016/icc_wc_t20_2016_g12/","venue":"Himachal Pradesh Cricket Association Stadium, Dharamsala, India","teams":{"a":{"short_name":"BAN","name":"Bangladesh","key":"ban"},"b":{"short_name":"OMN","name":"Oman","key":"omn"}},"players":{"t_iqbal":{"fullname":"Tamim Iqbal","name":"Tamim Iqbal","match":{"innings":{"1":{"fielding":{},"batting":{"dots":19,"sixes":5,"runs":103,"balls":63,"fours":10,"strike_rate":163.49},"bowling":{}}}},"identified_roles":{"keeper":false,"batsman":true,"bowler":false}}},"data_review_checkpoint":"post-match-validated","first_batting":"a","result_by":"runs"},{"related_name":"11th Match - Group A","msgs":{"info":"Netherlands won by 12 runs.","completed":"Netherlands won by 12 runs.","match_comments":"Reduced to 6 overs due to rain.","others":[]},"toss":{"decision":"bowl","won":"a","str":"Ireland won the toss and chose to bowl first"},"approx_completed_ts":1457876203,"winner_team":"b","winning_ratio":{"a":null,"b":null},"innings":{"b_1":{"wide":2,"runs":59,"balls":36,"sixes":1,"overs":"6.0","fours":8,"run_str":"59/5 in 6.0","wickets":5,"noball":0,"dotballs":14,"extras":8,"key":"b_1","legbye":2,"bye":4,"run_rate":"9.83"},"a_1":{"wide":2,"runs":47,"balls":36,"sixes":2,"overs":"6.0","fours":2,"run_str":"47/7 in 6.0","wickets":7,"noball":1,"dotballs":16,"extras":9,"key":"a_1","legbye":2,"bye":4,"run_rate":"7.83"}},"title":"Ireland vs Netherlands - 11th Match - Group A - ICC World Cup Twenty20 2016","dl_applied":false,"start_date":{"timestamp":1457861400,"iso":"2016-03-13T09:30+00:00","str":"13th Mar 2016 09:30 GMT"},"status":"completed","man_of_match":"p_meekeren","description":"Netherlands won by 12 runs. Ireland scored 47/7 in 6.0 and Netherlands scored 59/5 in 6.0. Paul van Meekeren played good and he is man of the match.","short_name":"IRE vs NL","format":"t20","season":{"name":"ICC World Cup Twenty20 2016","key":"icc_wc_t20_2016"},"expires":"1457970042.0","status_overview":"result","match_overs":6,"key":"icc_wc_t20_2016_g11","now":{"bowling_team":"b","nonstriker":null,"runs_str":"47/7 in 6.0","batting_team":"a","innings":"1","req":{"runs_str":"","balls":0,"runs_rate":0.0,"runs":0,"target_runs":60,"target_balls":36},"runs":47,"striker":null,"break":{"duration":"","reason":""},"bowler":null,"next_ball":{},"wicket":7,"run_rate":"7.83","recent_overs_str":[[6,["r2","r2","w","w","r1","e1,nb","r1"]],[5,["r1","r0","r1","r2","r1","r0"]],[4,["r1","w","w","r0","r1","r1"]]],"balls":36},"day":"","name":"Ireland vs Netherlands","ref":"http://www.litzscore.com/series/icc_wc_t20_2016/icc_wc_t20_2016_g11/","venue":"Himachal Pradesh Cricket Association Stadium, Dharamsala, India","teams":{"a":{"short_name":"IRE","name":"Ireland","key":"ire"},"b":{"short_name":"NL","name":"Netherlands","key":"nl"}},"players":{"p_meekeren":{"fullname":"Paul van Meekeren","name":"PA Meekeren","match":{"innings":{"1":{"fielding":{},"batting":{},"bowling":{"runs":11,"balls":12,"maiden_overs":0,"wickets":4,"extras":1,"overs":"2.0","economy":5.5}}}},"identified_roles":{"keeper":false,"batsman":false,"bowler":true}}},"data_review_checkpoint":"post-match-validated","first_batting":"b","result_by":"runs"},{"related_name":"10th Match - Group B","msgs":{"info":"Scotland won by 8 wickets.","completed":"Scotland won by 8 wickets.","others":[]},"toss":{"decision":"bat","won":"a","str":"Hong Kong won the toss and chose to bat first"},"approx_completed_ts":1457804795,"winner_team":"b","winning_ratio":{"a":null,"b":null},"innings":{"b_1":{"wide":0,"runs":78,"balls":48,"sixes":3,"overs":"8.0","fours":8,"run_str":"78/2 in 8.0","wickets":2,"noball":0,"dotballs":18,"extras":2,"key":"b_1","legbye":1,"bye":1,"run_rate":"9.75"},"a_1":{"wide":2,"runs":127,"balls":120,"sixes":3,"overs":"20.0","fours":8,"run_str":"127/7 in 20.0","wickets":7,"noball":0,"dotballs":45,"extras":7,"key":"a_1","legbye":4,"bye":1,"run_rate":"6.35"}},"title":"Hong Kong vs Scotland - 10th Match - Group B - ICC World Cup Twenty20 2016","dl_applied":true,"start_date":{"timestamp":1457791200,"iso":"2016-03-12T14:00+00:00","str":"12th Mar 2016 14:00 GMT"},"status":"completed","man_of_match":"m_machan","description":"Scotland won by 8 wickets. Hong Kong scored 127/7 in 20.0 and Scotland scored 78/2 in 8.0. Matt Machan played good and he is man of the match.","short_name":"HKG vs SCT","format":"t20","season":{"name":"ICC World Cup Twenty20 2016","key":"icc_wc_t20_2016"},"expires":"1457970042.0","status_overview":"result","match_overs":10,"key":"icc_wc_t20_2016_g10","now":{"bowling_team":"a","nonstriker":null,"runs_str":"78/2 in 8.0","batting_team":"b","innings":"1","req":{"runs_str":"","balls":0,"runs_rate":0.0,"runs":0,"target_runs":76,"target_balls":60},"runs":78,"striker":null,"break":{"duration":"","reason":""},"bowler":null,"next_ball":{},"wicket":2,"run_rate":"9.75","recent_overs_str":[[8,["r2","r0","r0","r2","r1","b6"]],[7,["w","r1","b4","r4","r1","r1"]],[6,["r2","r0","r1","b4","b6","r1"]]],"balls":48},"day":"","name":"Hong Kong vs Scotland","ref":"http://www.litzscore.com/series/icc_wc_t20_2016/icc_wc_t20_2016_g10/","venue":"Vidarbha Cricket Association Ground, Nagpur, India","teams":{"a":{"short_name":"HKG","name":"Hong Kong","key":"hkg"},"b":{"short_name":"SCT","name":"Scotland","key":"sct"}},"players":{"m_machan":{"fullname":"Matt Machan","name":"M Machan","match":{"innings":{"1":{"fielding":{},"batting":{"dots":0,"sixes":1,"runs":15,"balls":4,"fours":1,"strike_rate":375.0},"bowling":{"runs":26,"balls":24,"maiden_overs":0,"wickets":2,"extras":0,"overs":"4.0","economy":6.5}}}},"identified_roles":{"keeper":false,"batsman":true,"bowler":true}}},"data_review_checkpoint":"post-match-validated","first_batting":"a","result_by":"wickets"}],"intelligent_order":["icc_wc_t20_2016_g12","icc_wc_t20_2016_g13","icc_wc_t20_2016_g11","icc_wc_t20_2016_g14","icc_wc_t20_2016_g10","icc_wc_t20_2016_g15"]}}

    Match API

    • With match API you will get,
    • Super fast live update for cricket score.
    • Toss information.
    • Playing 11.
    • Short description about the match with timing and venue details.
    • Alert for live matches.
    • Notification for fall of wickets.
    • Squad details with exclusive player photos.
    • Man of the match for completed matches.
    • Automatic ball by ball comments.

    Schedule API

    • Correct match start time in GMT
    • Country codes of participating teams with expanded country names
    • Venue details with stadium name, place and country.
    • Finely designed png flag images for all teams
    • Tiny description about the match schedule

    Season API

    • List of all matches in a season
    • List of all participating teams
    • Player info for all teams which contains player name,
    • Venue details with stadium name and place
    • Start date and time

    Stats API

    • Points table for all teams
    • Count for matches won, lost and tie
    • Net Run Rate for every teams
    • Points earned by a team
    • Overall tournament sixes, fours
    • Top four Runs, Wickets, Sixes, Fours, Boundaries,
    • Top four batsman, bowler, catches, bowlers boundaries