GETMatches in play
Paginated, 100 items per page.
/v2.2/livescores/ with t=live
Try it in the interactive referenceAll Livescores operations
Request
GET /v2.2/livescores/?user=USER&token=TOKEN&t=live&include=events,stats- Paginated: 100 items per page; read
meta.pagesand request the next pages withpage. - Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
include | no | Comma-separated datasets to embed in the response, without spaces. Supported values: events, stats, odds_prematch, odds_inplay. See the includes section. | events,stats |
utc | no | UTC offset applied to returned date/time values; time.timezone reports it, for example UTC+4.5. Decimal offsets are accepted and invalid values fall back to UTC. | 2 |
lang | no | Language code for localized names, for example en, es, de, fr, it, pt, tr, pl, ko or zh. Verified on country, continent and league catalogue names; match and statistics payloads are not translated. | en |
odds_format | no | Odds format on odds datasets: decimal (default), fractional or american. | decimal |
page | no | Page number on paginated operations, starting at 1. The response reports meta.page and meta.pages; a page beyond the last returns an empty data. | 1 |
Example response
{
"data": [
{
"id": 2554966,
"status": 1,
"status_name": "Inplay",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "212522",
"round_name": "18",
"season_id": "16165",
"season_name": "2026",
"stage_id": "2105",
"stage_name": "Regular Season - Superleague, Women 2026",
"group_id": "12943",
"group_name": "Superleague, Women 2026",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 13:00:00",
"date": "2026-09-04",
"time": "13:00:00",
"minute": null,
"timestamp": 1788526800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 1192523153,
"name": "Zhfk Krylya Sovetov Samara",
"short_code": "ZHF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1192523153.png",
"form": null,
"coach_id": null,
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#efc131",
"home_gk_second_color": "#333333",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 1192523152,
"name": "FC Dinamo Moscow",
"short_code": "DIN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1192523152.png",
"form": null,
"coach_id": null,
"kit_colors": {
"away_main_color": "#585858",
"away_second_color": "#585858",
"away_number_color": "#ffffff",
"away_gk_main_color": "#efc131",
"away_gk_second_color": "#333333",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 3218,
"name": "Premier League, Women",
"type": "Superleague, Women 2026",
"country_id": "100",
"country_name": "Russia",
"country_code": "ru",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/ru.png"
},
"scores": {
"home_score": "0",
"away_score": "1",
"ht_score": "0-1",
"ft_score": "0-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 5,
"away_position": 6
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 1
},
"weather_report": null,
"events": [],
"stats": [
{
"team_id": 1192523153,
"key_passes": null,
"passing_accuracy": null,
"fouls": null,
"injuries": null,
"corners": null,
"crosses": null,
"crossing_accuracy": null,
"offsides": null,
"shots_total": null,
"shots_on_target": null,
"shots_off_target": null,
"shots_blocked": null,
"possessiontime": null,
"possessionpercent": null,
"yellowcards": null,
"yellowredcards": null,
"redcards": null,
"substitutions": null,
"goal_kick": null,
"goal_attempts": null,
"free_kick": null,
"throw_in": null,
"ball_safe": null,
"goals": null,
"penalties": null,
"attacks": null,
"dangerous_attacks": null,
"action_areas": null,
"xg": null
}
]
},
{
"id": 2623911,
"status": 1,
"status_name": "Inplay",
"status_period": "2nd Half",
"pitch": null,
"referee_id": null,
"round_id": null,
"round_name": null,
"season_id": "21185",
"season_name": "2026",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "13769",
"group_name": "U20 Carioca, Serie A 2026, Taca Guanabara",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "5034",
"leg": null,
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 13:00:00",
"date": "2026-09-04",
"time": "13:00:00",
"minute": "92",
"timestamp": 1788526800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 1829638371,
"name": "Bangu AC RJ",
"short_code": "BAN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1829638371.png",
"form": null,
"coach_id": null,
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#efc131",
"home_gk_second_color": "#333333",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 7825,
"name": "CR Flamengo RJ U20",
"short_code": "FLA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/7825.png",
"form": null,
"coach_id": "9454",
"kit_colors": {
"away_main_color": "#ff0000",
"away_second_color": "#000000",
"away_number_color": "#000000",
"away_gk_main_color": "#efc131",
"away_gk_second_color": "#333333",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 5548,
"name": "U20 Carioca, Serie A",
"type": "U20 Carioca, Serie A 2026, Taca Guanabara",
"country_id": "25",
"country_name": "Brazil",
"country_code": "br",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/br.png"
},
"scores": {
"home_score": "0",
"away_score": "2",
"ht_score": "0-1",
"ft_score": "0-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 11,
"away_position": 1
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 1
},
"weather_report": {
"desc": "clear/sunny",
"temp": {
"celsius": 28.9,
"fahrenheit": 84
},
"wind": {
"kmph": 10.6,
"miles": 6.59,
"direction": "NW"
},
"humidity_percent": 52,
"pressure": 1014
},
"events": [
{
"team_id": 1829638371,
"type": "corner",
"period": "1st half",
"player_id": null,
"player_name": null,
"related_player_id": null,
"related_player_name": null,
"minute": "3",
"extra_minute": null,
"timestamp": null,
"reason": null,
"injuried": null,
"own_goal": false,
"penalty": false,
"result": null,
"info": "1st Corner kick"
}
],
"stats": [
{
"team_id": 1829638371,
"key_passes": null,
"passing_accuracy": null,
"fouls": null,
"injuries": null,
"corners": "3",
"crosses": null,
"crossing_accuracy": null,
"offsides": null,
"shots_total": 16,
"shots_on_target": "1",
"shots_off_target": "15",
"shots_blocked": null,
"possessiontime": 45,
"possessionpercent": 50,
"yellowcards": "3",
"yellowredcards": null,
"redcards": "0",
"substitutions": "3",
"goal_kick": null,
"goal_attempts": null,
"free_kick": null,
"throw_in": null,
"ball_safe": null,
"goals": 0,
"penalties": "0",
"attacks": "134",
"dangerous_attacks": "68",
"action_areas": null,
"xg": null
}
]
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 59,
"total": 59,
"msg": ""
}
}