Request
GET /v2.2/livescores/?api_key=API_KEY&t=live&include=events,stats
- Paginated: 100 items per page; read
meta.pages and request the next pages with page. - Available on every plan for the leagues the plan covers.
- Authenticate with
api_key=API_KEY in the URL, or Authorization: Bearer API_KEY as an alternative. Both use the same key, without a username. See authentication methods.
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 |
bookmaker_ids | no | Comma-separated bookmaker IDs, without spaces, for include=odds_prematch, include=odds_inplay or both on livescores and fixture operations that accept these includes. Only the requested bookmakers are returned, in the supplied order within each market’s bookmakers array, where odds are available. For example, 9,2 selects bookmakers 9 then 2; 9,3,1 selects 9 then 3 then 1; 2 selects only bookmaker 2. | 9,2 |
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 catalogue names. Available codes: en, el, aa, it, de, es, ru, nl, pl, fr, pt, ka, vi, hi, tr, id, th, zh, zht, ro, ko and fa. Legacy aliases: gr maps to el, and ar maps to aa. Defaults to en; an unavailable code returns 400 Bad Request. Proper names can remain unchanged, and match, event, odds and statistics payloads are not translated. | en |
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": ""
}
}
