LIVE MATCH SCORE API

Live match

Membership

The score, the minute and the events so far of a match being played now. Answers refresh every 5 seconds. Live scores are part of membership.

GET/v1/live/{match_id}

TRY ITMembership

X-API-Key

Kept in this browser for every docs page. No key yet? Get a free key

match_idrequired

GET https://api.footballapi.org/v1/live/mt_4gfmswg7x

The answer appears below, with its status and time.

curl "https://api.footballapi.org/v1/live/mt_4gfmswg7x" \
  -H "X-API-Key: your key"

PARAMETERS

match_idrequiredstringA match id from any result, fixture or match list, such as mt_e2hk79mn5. In the path.

RETURNS

match_idstringOur id for the match, mt_ and 9 characters, the same in every answer and for good

competitionstringThe competition's name in the collection, such as premier-league

country_namestringThe country, or World or Europe for a tournament

competition_namestringThe competition as people write it

season_start_yearintegerThe first year of the season: 2026 for 2026/27

kickoff_utcstringKickoff in UTC, ISO 8601

kickoff_datestringThe day of kickoff in UTC, YYYY-MM-DD

kickoff_local_datestringThe day of kickoff where the match is played

kickoff_local_timestringThe time of kickoff where the match is played

match_statusstringWhere the match stands, such as finished or not started

home_club_idstringOur id for the home club

home_club_namestringThe home club

away_club_idstringOur id for the away club

away_club_namestringThe away club

home_goalsintegerHome goals at full time

away_goalsintegerAway goals at full time

full_time_resultnull or morehome, away or draw, at full time

half_time_home_goalsintegerHome goals at half time

half_time_away_goalsintegerAway goals at half time

half_time_resultnull or morehome, away or draw, at half time

stoppage_minutesnull or moreMinutes of added time; null when not recorded

is_kickoff_rescheduledbooleanWhether kickoff moved from its first date or time

elapsed_minutesintegerMinutes played so far while the match is on; null otherwise

home_league_positionnull or moreThe home side's place in its league before kickoff

away_league_positionintegerThe away side's place in its league before kickoff

away_travel_kmintegerHow far the away side came, ground to ground, in kilometres

ground_namestringThe ground

city_namestringThe city of the ground

latitudenumberWhere the ground is, north to south

longitudenumberWhere the ground is, east to west

location_precisionstringHow exact latitude and longitude are: ground, or city

daylight_minutesintegerMinutes of daylight that day at the ground

sun_elevation_degnumberThe sun's height at kickoff, in degrees; below 0 after dark

public_holidaynull or moreThe public holiday that day where the match is played; null when none

kickoff_temperature_cnull or moreThe temperature at kickoff, in degrees C; null when not recorded

kickoff_rain_mmnull or moreRain in the hour of kickoff, in millimetres; null when not recorded

kickoff_wind_msnull or moreWind at kickoff, in metres a second; null when not recorded

attendancenull or moreThe crowd; null when not recorded

referee_namenull or moreThe referee

regular_time_home_goalsnull or moreHome goals after 90 minutes and added time

regular_time_away_goalsnull or moreAway goals after 90 minutes and added time

regular_time_resultnull or morehome, away or draw, after 90 minutes and added time

extra_time_home_goalsnull or moreHome goals after extra time; null when there was none

extra_time_away_goalsnull or moreAway goals after extra time; null when there was none

shootout_home_goalsnull or moreHome penalties scored in a shootout; null when there was none

shootout_away_goalsnull or moreAway penalties scored in a shootout; null when there was none

club_figuresnull or moreEach side's figures for the match

EXAMPLE ANSWER

200GET /v1/live/mt_4gfmswg7x, taken 21 Oct 2026

{
  "data": {
    "match_id": "mt_4gfmswg7x",
    "competition": "veikkausliiga",
    "country_name": "Finland",
    "competition_name": "Veikkausliiga",
    "season_start_year": 2026,
    "kickoff_utc": "2026-10-21T15:30:00Z",
    "kickoff_date": "2026-10-21",
    "kickoff_local_date": "2026-10-21",
    "kickoff_local_time": "15:30",
    "match_status": "in_play_second_half",
    "home_club_id": "cl_9bkc78m1c",
    "home_club_name": "PK-35",
    "away_club_id": "cl_de2y39a71",
    "away_club_name": "FF Jaro",
    "home_goals": 1,
    "away_goals": 1,
    "full_time_result": null,
    "half_time_home_goals": 1,
    "half_time_away_goals": 1,
    "half_time_result": null,
    "stoppage_minutes": null,
    "is_kickoff_rescheduled": false,
    "elapsed_minutes": 46,
    "home_league_position": null,
    "away_league_position": 11,
    "away_travel_km": 407,
    "ground_name": "Mustapekka Areena",
    "city_name": "Helsinki",
    "latitude": 60.170833333333,
    "longitude": 24.9375,
    "location_precision": "city",
    "daylight_minutes": 584,
    "sun_elevation_deg": -4.8,
    "public_holiday": null,
    "kickoff_temperature_c": null,
    "kickoff_rain_mm": null,
    "kickoff_wind_ms": null,
    "attendance": null,
    "referee_name": null,
    "regular_time_home_goals": null,
    "regular_time_away_goals": null,
    "regular_time_result": null,
    "extra_time_home_goals": null,
    "extra_time_away_goals": null,
    "shootout_home_goals": null,
    "shootout_away_goals": null,
    "club_figures": null
  },
  "meta": {
    "refreshed_seconds": 5,
    "request_id": "req_f8f3c7dff5841146"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.

400bad_requestA parameter is missing or not in the right form; the message names it.

403upgrade_requiredLive scores are part of membership.

404not_foundAn id or competition we do not have.

422unknown_parameterA parameter this endpoint does not take.

429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.

PREVIOUSLive NEXTClubs