Flashscore player match log API

Endpoint facts

Method

GET

API path

/flashscore/player-match-log

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

Flashscore

How this endpoint behaves

Returns one page of a football, basketball or hockey player's match log, newest first: the same table the Flashscore player page shows under "Last matches". Each row has the match date, both sides with scores, the competition, the player's Flashscore rating and labelled statistics. Players of individual sports (tennis, darts, golf, snooker) have no match log and return an empty list; use /api/v1/flashscore/player-results for them.

Query parameters:

• id (required): eight-character Flashscore player id from a player URL (/player/<slug>/<id>/), /api/v1/flashscore/search or a lineup or squad response. A team id returns 404, and so does an unknown id.
• page (optional, default 1): 1-based page from 1 to 300. Page 1 holds the 10 newest matches (the block embedded in the player page); every later page holds 25 older matches. Request pages until has_more is false. A page past the end returns an empty rows list.

Response fields:

• player: the same profile object as /api/v1/flashscore/player.
• page, row_count, has_more, rows.
• Row fields: event_id (works with the flashscore/match-* endpoints), date (ISO date) and date_text (as Flashscore prints it, dd.mm.yy), stage and stage_code, home and away, result, tournament, rating, rating_rank, stats_available, absence and stats.
• stage is one of finished (code 3), finished_after_extra_time (code 10), finished_after_penalties (code 11) or other.
• home and away carry id, name, short_name, slug, logo_url and the scores: score (final score), full_time_score, score_after_extra_time and penalties_score. The last three are omitted when there was no extra time or shoot-out.
• result is win, draw or loss for the player's own team in that match.
• tournament: name (for example Premier League (England)), short_code, season, country, country_id and path.
• rating is Flashscore's 1-10 player rating when one was published. rating_rank is a rank (1 to 3 seen) Flashscore attaches to some rated rows and is omitted otherwise.
• stats lists the player's labelled statistics in the column order of the player page, each as {id, key, label, value}. value is shown exactly as Flashscore shows it (90', 29:21, 32-33, 97.00%, or a number). Pinned statistics (the numeric id is Flashscore's own):
  • football: minutes_played (595), goals (596), assists (541), yellow_cards (599) and red_cards (600); goalkeepers also have saves (649) and shots_faced (965) instead of goals and assists.
  • basketball: minutes_played (595), points (169), rebounds (713), assists (541), steals (696) and turnovers (697).
  • hockey: goals (596), assists (541), points (169), plus_minus (777) and time_on_ice (781); goalkeepers have save_percentage (715), saves (649) and time_on_ice (781).
  • An id this API does not know yet is returned with the key stat_<id> and the provider's own tag as label. A statistic whose provider tag contradicts the pinned meaning of its id fails the request with 503 instead of returning wrongly labelled data.
• When the player has no statistics for a match, stats_available is false and stats is empty. absence then explains why when Flashscore says so: {category, detail} with categories seen live such as on the bench, not in the squad, injured (detail Injury or Illness) and suspended (detail Red Card). Without an absence, Flashscore only says that statistics are not available for that match (baseball players, for example, have rows but no statistics).

Example response (shortened):

{"code":200,"msg":"OK","data":{"source_url":"https://global.flashscore.ninja/2/x/feed/plm_UmV9iQmE_0","player":{"id":"UmV9iQmE","name":"Haaland E.","full_name":"Erling Haaland","country":"Norway","country_id":145,"sport_id":1,"sport":"football","slug":"haaland-erling","path":"/player/haaland-erling/UmV9iQmE/","url":"https://www.flashscore.com/player/haaland-erling/UmV9iQmE/","photo_url":"https://static.flashscore.com/res/image/data/2TPtAZFG-G41UWlHn.png","birth_date":"2000-07-21","team":{"id":"Wtn9Stg0","name":"Manchester City","logo_url":"https://static.flashscore.com/res/image/data/UXcqj7HG-lQuhqN8N.png"}},"page":1,"row_count":10,"has_more":true,"rows":[{"event_id":"Ei1jt6O0","date":"2026-10-04","date_text":"04.10.26","stage_code":3,"stage":"finished","home":{"id":"WvJrjFVN","name":"Portugal","short_name":"POR","slug":"portugal","logo_url":"https://static.flashscore.com/res/image/data/IBvrXaZg-vZG58BBc.png","score":2,"full_time_score":2},"away":{"id":"8rP6JO0H","name":"Norway","short_name":"NOR","slug":"norway","logo_url":"https://static.flashscore.com/res/image/data/MZeV1VdM-8doAmYTm.png","score":1,"full_time_score":1},"result":"loss","tournament":{"name":"UEFA Nations League (Europe)","short_code":"UNL","season":"2026-2027","country":"Europe","country_id":6,"path":"/football/europe/uefa-nations-league/"},"rating":6.5,"stats_available":true,"stats":[{"id":595,"key":"minutes_played","label":"Minutes played","value":"67'"}]}]}}

Live monitoring

Monitored request

GET /flashscore/player-match-log?id=UmV9iQmE

Checks passed, 7 days to 14 Oct 2026

99.7%

Median response time

3.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /flashscore/player-match-log?id=UmV9iQmE

Items in rows

10

Fields filled in every checked item

10

Fields empty in some or all items

4

Shared guides

Related