GETToday's matches
Paginated, 100 items per page.
/v2.2/livescores/ with t=today
Try it in the interactive referenceAll Livescores operations
Request
GET /v2.2/livescores/?user=USER&token=TOKEN&t=today&utc=2- 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": 2665019,
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "222765",
"round_name": "14",
"season_id": "21386",
"season_name": "26/27",
"stage_id": "9",
"stage_name": "Qualification",
"group_id": "14109",
"group_name": "CAF Champions League 26/27, Qualification",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": "1/2",
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 19:00:00",
"date": "2026-09-04",
"time": "19:00:00",
"minute": "",
"timestamp": 1788548400,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 28187,
"name": "AL Swehly SC",
"short_code": "SWE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/28187.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": 59734568,
"name": "Kvz",
"short_code": "KVZ",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/59734568.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": 516,
"name": "CAF Champions League",
"type": "CAF Champions League 26/27, Qualification",
"country_id": "136",
"country_name": "Africa",
"country_code": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": "-",
"ft_score": "-",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 0,
"away_position": 0
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 0
},
"weather_report": null
},
{
"id": 2665021,
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "222765",
"round_name": "14",
"season_id": "21386",
"season_name": "26/27",
"stage_id": "9",
"stage_name": "Qualification",
"group_id": "14109",
"group_name": "CAF Champions League 26/27, Qualification",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": "1/2",
"week": "36",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 19:00:00",
"date": "2026-09-04",
"time": "19:00:00",
"minute": "",
"timestamp": 1788548400,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 21993,
"name": "AS Port",
"short_code": "POR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/21993.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": 5183,
"name": "Zamalek SC",
"short_code": "ZAM",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/5183.png",
"form": null,
"coach_id": "1003",
"kit_colors": {
"away_main_color": "#000099",
"away_second_color": "#ffffff",
"away_number_color": "#ffffff",
"away_gk_main_color": "#000099",
"away_gk_second_color": "#000099",
"away_gk_number_color": "#ffffff"
}
}
},
"league": {
"id": 516,
"name": "CAF Champions League",
"type": "CAF Champions League 26/27, Qualification",
"country_id": "136",
"country_name": "Africa",
"country_code": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": "-",
"ft_score": "-",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 0,
"away_position": 0
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 0
},
"weather_report": null
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 7,
"count": 100,
"total": 645,
"msg": ""
}
}