GETYesterday's matches
Paginated, 100 items per page.
/v2.2/livescores/ with t=yesterday
Try it in the interactive referenceAll Livescores operations
Request
GET /v2.2/livescores/?user=USER&token=TOKEN&t=yesterday- 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": 2678164,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "221884",
"round_name": "1",
"season_id": "21329",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "14009",
"group_name": "Ligue 1 26/27",
"aggregate_id": null,
"winner_team_id": "17295",
"venue_id": "78",
"leg": null,
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-03 18:00:00",
"date": "2026-09-03",
"time": "18:00:00",
"minute": 90,
"timestamp": 1788458400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 5362,
"name": "ES Setif",
"short_code": "ESS",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/5362.png",
"form": null,
"coach_id": null,
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#3366ff",
"home_gk_second_color": "#3366ff",
"home_gk_number_color": "#ffffff"
}
},
"away": {
"id": 17295,
"name": "Ben Aknoun",
"short_code": "BAK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/17295.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": 799,
"name": "Ligue 1",
"type": "Ligue 1 26/27",
"country_id": "9",
"country_name": "Algeria",
"country_code": "dz",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/dz.png"
},
"scores": {
"home_score": "0",
"away_score": "1",
"ht_score": "0-0",
"ft_score": "0-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 1,
"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": 12,
"miles": 7.46,
"direction": "NNE"
},
"humidity_percent": 30,
"pressure": 1021
}
},
{
"id": 2668002,
"status": 4,
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "223081",
"round_name": "2",
"season_id": "21329",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "14009",
"group_name": "Ligue 1 26/27",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "3133",
"leg": null,
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-03 19:00:00",
"date": "2026-09-03",
"time": "19:00:00",
"minute": null,
"timestamp": 1788462000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 5371,
"name": "MC Oran",
"short_code": "MCO",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/5371.png",
"form": null,
"coach_id": null,
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#66ff00",
"home_gk_second_color": "#000000",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 17299,
"name": "CR Temouchent",
"short_code": "CRT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/17299.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": 799,
"name": "Ligue 1",
"type": "Ligue 1 26/27",
"country_id": "9",
"country_name": "Algeria",
"country_code": "dz",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/dz.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": "-",
"ft_score": "-",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 1,
"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": "partly cloudy",
"temp": {
"celsius": 27.3,
"fahrenheit": 81.1
},
"wind": {
"kmph": 4.9,
"miles": 3.04,
"direction": "NNE"
},
"humidity_percent": 89,
"pressure": 1019
}
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 3,
"count": 100,
"total": 257,
"msg": ""
}
}