GETToday's matches ended
Paginated, 100 items per page.
/v2.2/livescores/ with t=ended
Try it in the interactive referenceAll Livescores operations
Request
GET /v2.2/livescores/?user=USER&token=TOKEN&t=ended- 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": 2672759,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "223566",
"round_name": "6",
"season_id": "21094",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "13691",
"group_name": "Premier League 26/27",
"aggregate_id": null,
"winner_team_id": "0",
"venue_id": "2967",
"leg": null,
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 12:00:00",
"date": "2026-09-04",
"time": "12:00:00",
"minute": 90,
"timestamp": 1788523200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 703569628,
"name": "FC Syunik",
"short_code": "SYU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/703569628.png",
"form": null,
"coach_id": "8843",
"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": 4390,
"name": "FC Pyunik Yerevan",
"short_code": "PYU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/4390.png",
"form": null,
"coach_id": "1262",
"kit_colors": {
"away_main_color": "#b20016",
"away_second_color": "#d8924e",
"away_number_color": "#d99349",
"away_gk_main_color": "#000000",
"away_gk_second_color": "#000000",
"away_gk_number_color": "#ffffff"
}
}
},
"league": {
"id": 865,
"name": "Premier League",
"type": "Premier League 26/27",
"country_id": "13",
"country_name": "Armenia",
"country_code": "am",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/am.png"
},
"scores": {
"home_score": "0",
"away_score": "0",
"ht_score": "0-0",
"ft_score": "0-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 11,
"away_position": 4
},
"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": 27,
"fahrenheit": 80.6
},
"wind": {
"kmph": 12.7,
"miles": 7.89,
"direction": "E"
},
"humidity_percent": 33,
"pressure": 1013
}
},
{
"id": 2680483,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "224148",
"round_name": "Final",
"season_id": "20968",
"season_name": "2026",
"stage_id": "12",
"stage_name": "Relegation Playoffs",
"group_id": "14272",
"group_name": "NSW League One 2026, Rel/Prom Playoffs",
"aggregate_id": null,
"winner_team_id": "16110",
"venue_id": "7440",
"leg": "1/2",
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 09:30:00",
"date": "2026-09-04",
"time": "09:30:00",
"minute": 90,
"timestamp": 1788514200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 16110,
"name": "Parramatta FC Eagles",
"short_code": "PAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/16110.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": 22785,
"name": "Prospect United",
"short_code": "PRO",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/22785.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": 6115,
"name": "NSW League One",
"type": "NSW League One 2026, Rel/Prom Playoffs",
"country_id": "14",
"country_name": "Australia",
"country_code": "au",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/au.png"
},
"scores": {
"home_score": "4",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "4-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 0,
"away_position": 15
},
"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
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 90,
"total": 90,
"msg": ""
}
}