# Flashscore API — live scores, fixtures and results for 34 sports, match statistics, lineups, odds, standings, teams, players and rankings

> Every sport Flashscore has a page for (34) with today's event count and how many are live right now.
> ReefAPI engine `flashscore` · 52 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/flashscore/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/flashscore/v1/sports — 1 credit
Every sport Flashscore has a page for (34) with today's event count and how many are live right now.

**Parameters:** none

**Returns:** sports[]{id, name, slug, link, events_today, live_now, format}

### POST https://api.reefapi.com/flashscore/v1/countries — 1 credit
The country / category menu of one sport (for tennis: ATP Singles, WTA Doubles … categories).

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** countries[]{id, name, slug, link, section}

### POST https://api.reefapi.com/flashscore/v1/tournaments — 1 credit
Every competition of one country in one sport, in the site's own menu order, with the link the tournament_* actions take.

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]
- `country` (string, required) — Country name, slug or id from `countries`.

**Returns:** country{id, name, slug} + competitions[]{name, slug, template_id, link, tournament}

**Example request body:**
```json
{
  "country": "England"
}
```

### POST https://api.reefapi.com/flashscore/v1/search — 1 credit
Search teams, players and competitions by name (Flashscore's own search box; it returns up to 20 hits). Rows carry the id and link every other action takes.

**Parameters:**
- `query` (string, required) — At least 2 characters.
- `type` (enum, optional, default "all") — Limit to one kind of result. [one of: all, team, player, tournament]
- `sport` (enum, optional) — Limit to one sport. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** results[]{id, type, name, slug, link, sport, country, gender, image, (tournament: tournament_id, stage_id, reference), (player: teams)}

**Example request body:**
```json
{
  "query": "arsenal"
}
```

### POST https://api.reefapi.com/flashscore/v1/resolve — 1 credit
Turn any flashscore.com link into the ids this API takes (match, team, player, competition with its tournament/stage/template/season ids).

**Parameters:**
- `url` (string, required) — A flashscore.com link.

**Returns:** type, id(s), link, reference

**Example request body:**
```json
{
  "url": "https://www.flashscore.com/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/matches — 1 credit
All matches of one sport on one day (today ±7 days), grouped by competition, with scores, period scores, stage and both sides. Golf, motorsport, cycling, horse racing and winter sports return a `leaderboard` per event instead.

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]
- `date` (string, optional) — YYYY-MM-DD within today ±7 days (in `timezone`).
- `day` (integer, optional, default 0) — Day offset from today, -7…7 (used when `date` is not given).
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
- `status` (enum, optional, default "all") — Keep only these. [one of: all, scheduled, live, finished]

**Returns:** date, total, competitions[]{competition{name, country, tournament_id, stage_id, template_id, link}, matches[]{id, status, stage, start_time, home, away, home_score, away_score, periods[], round, …} | leaderboard[]}

**Example request body:**
```json
{
  "sport": "football"
}
```

### POST https://api.reefapi.com/flashscore/v1/live_matches — 1 credit
Matches of one sport in play right now, grouped by competition.

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** same shape as `matches`

**Example request body:**
```json
{
  "timezone": "Europe/London"
}
```

### POST https://api.reefapi.com/flashscore/v1/live_updates — 2 credits
The small change feed the site polls every few seconds: only the matches whose score, stage or serve just changed.

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** updates[]{id, status, stage, scores, periods, changed{}}

### POST https://api.reefapi.com/flashscore/v1/match — 2 credits
One match: both sides (ids, names, logos, ranking), competition and round, status, scores incl. penalties, the tabs the match has, venue, referee, capacity and attendance.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + competition{name, link, country}, round, home{…}, away{…}, match_info{referee, venue, town, capacity, attendance}, canonical_url

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_summary — 2 credits
Timeline of events: goals (scorer, assist), cards with reason, substitutions (in and out), VAR, with the running score per period.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + periods[]{period, home_score, away_score, incidents[]{minute, team, type, players[], description, reason}}, match_info

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_statistics — 2 credits
Team statistics (xG, possession, shots, passes, duels … as the site publishes per sport) for the match and each half/period.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
- `period` (string, optional) — Only this period (Match, 1st Half, 2nd Half …).

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + available_periods, periods[]{period, groups[]{group, statistics[]{name, home, away, home_value, away_value}}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_lineups — 2 credits
Lineups: formation, starters, substitutes, coaches, shirt numbers, player ratings, captain/goalkeeper roles, substitutions with minutes.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + lineups_published, home/away{name, formation, formation_lines, groups[]{type, players[]}, coaches, substitutions, average_rating}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_predicted_lineups — 2 credits
Predicted lineups the site shows before kick-off.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + home/away{formation, groups[]{players[]}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_missing_players — 2 credits
Injured, suspended and doubtful players of both sides with the reason.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + home[], away[]{name, status, reason}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_player_statistics — 3 credits
Per-player match statistics (about 90 types for football: rating, minutes, xG, passes, duels …).

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + published, teams, stat_groups, stat_types, players[]{name, team, position, rating, statistics[]{id, name, value}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_h2h — 2 credits
Head-to-head: each side's last matches and the previous meetings, per tab (overall / home / away; surfaces for tennis).

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + tabs[]{tab, sections[]{name, matches[]}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_odds — 2 credits
Bookmaker odds comparison for the match (1X2, over/under, Asian handicap, both teams to score …), opening and current odds. Bookmakers depend on `geo`.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
- `geo` (string, optional, default "US") — 2-letter country code whose bookmakers to show (US, GB, DE, IN …).
- `bet_type` (string, optional) — Only one market type.
- `bet_scope` (string, optional) — FULL_TIME, FIRST_HALF or SECOND_HALF.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + geo, bookmakers[], markets[]{bookmaker, bet_type, bet_scope, selections[]{selection, odds, opening_odds, handicap, active, result}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_commentary — 2 credits
Live text commentary, minute by minute.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + comments[]{minute, clock, text, is_key_moment}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_point_by_point — 2 credits
Tennis / table tennis point-by-point: every game of every set with server, breaks and the point sequence.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + sets[]{name, games[]{home_games, away_games, server, game_winner, points[]}}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_standings — 2 credits
The competition table as the match page shows it.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
- `type` (enum, optional, default "overall") — Which table: league table, home/away split, form, over/under, half-time/full-time. [one of: overall, home, away, form, form_home, form_away, over_under, over_under_home, over_under_away, ht_ft, ht_ft_home, ht_ft_away]
- `line` (string, optional, default "all") — Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + type, rows[]{rank, team, matches_played, wins, draws, losses, goals_for, goals_against, points, form[]}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_top_scorers — 2 credits
The competition's top scorers, from the match page.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + top_scorers[]{rank, player, team, goals, assists}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_report — 2 credits
Match report / preview article published on the match page.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + report[]{title, link, image, published_at, source}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_news — 2 credits
News on the match page: headlines and the Flashscore article ids about both sides.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + headlines[], article_ids[]

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_broadcasts — 2 credits
TV channels by country and streaming providers.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + tv_listing, tv_channels[]{name, link}, streaming[]

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_highlights — 2 credits
Video highlights linked on the match page.

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + highlights[]{title, url, embed_url, image}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/match_momentum — 2 credits
Match momentum graph values, minute by minute (football).

**Parameters:**
- `match` (string, required) — Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** id, link, sport, status, stage, start_time (UTC), start_time_local, home_score, away_score, home_score_incl_shootout, away_score_incl_shootout, winner, available_tabs + momentum[]{from_minute, to_minute, value}

**Example request body:**
```json
{
  "match": "AJh0DeXa"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament — 3 credits
One competition: name, country, current season, stages with dates, winners, ids.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `season` (string, optional) — Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).

**Returns:** name, country, season, tournament_id, stage_id, template_id, stages[], winners

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_seasons — 3 credits
Every season of a competition with its id pair, link and winner (the archive).

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.

**Returns:** seasons[]{season, tournament_id, stage_id, reference, link, winners}

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_standings — 1 credit
Standings: overall, home, away, form, over/under, half-time/full-time, with zones and form strip.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `type` (enum, optional, default "overall") — Which table: league table, home/away split, form, over/under, half-time/full-time. [one of: overall, home, away, form, form_home, form_away, over_under, over_under_home, over_under_away, ht_ft, ht_ft_home, ht_ft_away]
- `line` (string, optional, default "all") — Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.
- `season` (string, optional) — Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).

**Returns:** title, rows[]{rank, team, matches_played, wins, draws, losses, goals_for, goals_against, goal_difference, points, zone, form[]}, zones

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_standings_types — 2 credits
Which standings tables a competition publishes.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `season` (string, optional) — Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).

**Returns:** standings_types[]{type, line, tab}

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_results — 1 credit
Finished matches of a competition season, newest first, about 100 per page.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** page, count, total, page_beyond_last, matches[]

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_fixtures — 1 credit
Upcoming matches of a competition season, about 100-120 per page.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** page, count, total, page_beyond_last, matches[]

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_top_scorers — 1 credit
Top scorers of a competition season.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `season` (string, optional) — Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).

**Returns:** top_scorers[]{rank, player, team, country, goals, assists}

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/tournament_draw — 2 credits
Knockout bracket (cups, tennis tournaments): every tie by round with seeds, score and winner.

**Parameters:**
- `tournament` (string, required) — Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
- `season` (string, optional) — Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).

**Returns:** rounds, ties[]{round, match_id, home{name, seed}, away, home_score, away_score, winner}

**Example request body:**
```json
{
  "tournament": "/football/england/premier-league/"
}
```

### POST https://api.reefapi.com/flashscore/v1/team — 2 credits
Team profile: name, sport, country, logo, stadium and capacity, current competition and its seasons, competitions won.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `sport` (enum, optional) — The team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** id, name, sport, country, logo, venue{name, city, capacity}, current_competition, competition_seasons, competitions_won

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_squad — 2 credits
Squad by position with shirt number, age, appearances, minutes, goals, assists and cards — per competition filter the site shows.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `competition` (string, optional) — Only this competition's table (Total = all).
- `sport` (enum, optional) — The team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** available_competitions, competitions[]{competition, groups[]{group, players[]}}

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_results — 2 credits
A team's finished matches, newest first, 40 per page, going back many seasons.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `sport` (enum, optional) — The team's sport; saves one page lookup. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** page, count, page_beyond_last, matches[]

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_fixtures — 1 credit
A team's upcoming matches.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `sport` (enum, optional) — The team's sport; saves one page lookup. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]
- `timezone` (string, optional, default "UTC") — IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.

**Returns:** page, count, page_beyond_last, matches[]

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_transfers — 1 credit
Arrivals and departures: date, player, both clubs, type (loan, transfer, free) and fee; 15 per page.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `direction` (enum, optional, default "all") [one of: all, in, out]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `sport` (enum, optional) — The team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** transfers[]{date, direction, type, fee{amount, currency}, player, from_team, to_team}

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_standings — 1 credit
The table of the league the team plays in now.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `type` (enum, optional, default "overall") — Which table: league table, home/away split, form, over/under, half-time/full-time. [one of: overall, home, away, form, form_home, form_away, over_under, over_under_home, over_under_away, ht_ft, ht_ft_home, ht_ft_away]
- `line` (string, optional, default "all") — Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.
- `sport` (enum, optional) — The team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** same as tournament_standings + team

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_top_scorers — 1 credit
Top scorers of the league the team plays in now.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
- `sport` (enum, optional) — The team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** same as tournament_top_scorers

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/team_news — 1 credit
Headlines about the team.

**Parameters:**
- `team` (string, required) — Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.

**Returns:** articles[]{title, link, image, published_at, source}

**Example request body:**
```json
{
  "team": "hA1Zm19f"
}
```

### POST https://api.reefapi.com/flashscore/v1/player — 2 credits
Player profile with everything the page shows: position, club, age, birth date, market value, contract end, career by season and competition, transfers, injury history and last matches with rating.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** name, position, team, country, age, date_of_birth, market_value, contract_expires, career[], transfers[], injuries[], last_matches[]

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/player_career — 2 credits
Career tables (league, domestic cups, international cups, national team): season, team, competition, rating, apps, goals, assists, cards.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** profile + career[]{name, seasons[], total}

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/player_transfers — 2 credits
Transfer history of a player.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** profile + transfers[]

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/player_injuries — 2 credits
Injury history of a player.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** profile + injuries[]

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/player_last_matches — 2 credits
A player's last matches with rating and minutes.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** profile + last_matches[]

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/player_news — 1 credit
Headlines about the player.

**Parameters:**
- `player` (string, required) — Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.

**Returns:** articles[]

**Example request body:**
```json
{
  "player": "Wn6E2SED"
}
```

### POST https://api.reefapi.com/flashscore/v1/rankings — 1 credit
Ranking tables a sport publishes (tennis ATP/WTA singles, doubles and race; football FIFA/UEFA …).

**Parameters:**
- `sport` (enum, optional, default "tennis") — Sport slug. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** rankings[]{tab_id, name, link}

### POST https://api.reefapi.com/flashscore/v1/ranking — 1 credit
One ranking table: rank, previous rank, player/team, country, points, tournaments played. Page 1 = top 100, page 2 = the rest.

**Parameters:**
- `ranking` (string, required) — Ranking link from `rankings`, or its 8-character id.
- `page` (integer, optional, default 1) — 1 = top 100, 2 = everyone after that.

**Returns:** name, updated_on, rows[]{rank, previous_rank, rank_change, player, country, points}

**Example request body:**
```json
{
  "ranking": "https://www.flashscore.com/tennis/rankings/wta/"
}
```

### POST https://api.reefapi.com/flashscore/v1/news — 1 credit
A sport's news front page, in the site's sections.

**Parameters:**
- `sport` (enum, optional, default "football") — Sport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too. [one of: football, tennis, basketball, hockey, american-football, baseball, handball, rugby-union, floorball, bandy, futsal, volleyball, cricket, darts, snooker, boxing, beach-volleyball, aussie-rules, rugby-league, badminton, water-polo, golf, field-hockey, table-tennis, beach-soccer, mma, netball, pesapallo, motorsport, cycling, horse-racing, esports, winter-sports, kabaddi]

**Returns:** sections[]{name, articles[]{id, title, link, published_at, image}}

### POST https://api.reefapi.com/flashscore/v1/news_article — 1 credit
One Flashscore news article in full.

**Parameters:**
- `article` (string, required) — Article id or flashscore.com/news link.

**Returns:** id, title, perex, link, published_at, image, body

**Example request body:**
```json
{
  "article": "88vzmJ5F"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=flashscore
- Human docs page: https://reefapi.com/docs/flashscore
- Overview page: https://reefapi.com/flashscore-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
