FlashLive Sports API - Complete Tutorial

Table of Contents

1. Introduction
2. Getting Started
3. API Basics
4. Authentication
5. Supported Sports
6. Locales/Languages
7. API Endpoints Reference
   • Search Endpoints
   • Sports Endpoints
   • Events Endpoints
   • Tournaments Endpoints
   • Teams Endpoints
   • Players Endpoints
   • Rankings Endpoints
   • News Endpoints
   • Images Endpoints
8. Common Workflows
9. Real-Time Updates
10. Data Types & Status Codes
11. Best Practices
12. Error Handling
13. FAQ

---

Introduction

FlashLive Sports API provides the fastest live scores, standings, and detailed statistics for thousands of competitions across 30+ sports. The API is designed for building applications similar to flashscore.com or livescore.com.

Key Features

• Real-time live scores and updates
• Comprehensive statistics for matches
• Player and team data
• Tournament standings and fixtures
• Odds data from multiple bookmakers
• Multi-language support (25 languages)
• Coverage from 1990 to present

Base URL

https://flashlive-sports-api.hgapi.top

Support

• Documentation: https://flashlive.rapi.one/
• Email: tipsters@rapi.one
• Telegram: https://t.me/api_tipsters

---

Getting Started

Quick Start Guide

Follow these steps to start using the FlashLive Sports API:

Step 1: Get a List of Sports

Use the /v1/sports/list endpoint to retrieve all available sports.

Request:

GET /v1/sports/list

Response:

{
  "DATA": [
    {"ID": 1, "NAME": "SOCCER"},
    {"ID": 2, "NAME": "TENNIS"},
    {"ID": 3, "NAME": "BASKETBALL"},
    {"ID": 4, "NAME": "HOCKEY"}
    // ... more sports
  ]
}

Step 2: Get List of Events

Use the /v1/events/list endpoint with a sport ID and timezone.

Request:

GET /v1/events/list?locale=en_GB&sport_id=1&timezone=0&indent_days=0

Parameters:

• locale: Language code (e.g., en_GB)
• sport_id: Sport ID from step 1
• timezone: Timezone offset
• indent_days: Days from current date (0 = today, -1 = yesterday, 1 = tomorrow)

Step 3: Get Event Details

Use various event endpoints to get detailed information about a specific event.

GET /v1/events/data?locale=en_GB&event_id=0jR7cwU6
GET /v1/events/statistics?locale=en_GB&event_id=0jR7cwU6
GET /v1/events/lineups?locale=en_GB&event_id=0jR7cwU6

---

API Basics

Request Format

All API requests are HTTP GET requests with query parameters.

GET /v1/{endpoint}?parameter1=value1&parameter2=value2

Response Format

All responses are in JSON format with the following structure:

{
  "DATA": { /* Response data */ },
  "META": { /* Metadata (optional) */ },
  "LAST_CHANGE_KEY": "hash_value" /* For caching/updates */
}

Time Format

• All timestamps are in Unix format (seconds since epoch)
• All times are in UTC+0
• Timezone parameter is only needed for /v1/events/list

---

Authentication

Authentication is handled via API key. Include your API key in the request headers or as a query parameter (depending on your subscription type).

---

Supported Sports

ID	Sport
1	Soccer
2	Tennis
3	Basketball
4	Hockey
5	American Football
6	Baseball
7	Handball
8	Rugby Union
9	Floorball
10	Bandy
11	Futsal
12	Volleyball
13	Cricket
14	Darts
15	Snooker
16	Boxing
17	Beach Volleyball
18	Aussie Rules
19	Rugby League
21	Badminton
22	Water Polo
23	Golf
24	Field Hockey
25	Table Tennis
26	Beach Soccer
28	MMA
29	Netball
30	Pesapallo
31	Motorsport
32	Autoracing
33	Motoracing
34	Cycling
35	Horse Racing
36	Esports
37	Winter Sports
38	Ski Jumping
39	Alpine Skiing
40	Cross Country
41	Biathlon
42	Kabaddi

---

Locales/Languages

The API supports 25 languages. Use the locale parameter in your requests.

Common locales:

• en_GB - English (UK)
• en_INT - English (International)
• de_DE - German
• fr_FR - French
• es_ES - Spanish
• it_IT - Italian
• pt_PT - Portuguese
• ru_RU - Russian
• zh_CN - Chinese (Simplified)

---

API Endpoints Reference

---

Search Endpoints

Multi Search

Search for teams, tournaments, and players. Results are shown as you type.

Endpoint: GET /v1/search/multi-search

Description: Search teams, tournaments and players. Results are shown as you type.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
query	string	Yes	Search query (2-50 characters)

Example Request:

GET /v1/search/multi-search?locale=en_GB&query=mess

Example Response:

[
  {
    "ID": "vgOOdZbd",
    "TYPE": "playersInTeam",
    "SPORT_ID": 1,
    "FLAG_ID": 22,
    "COUNTRY_ID": 22,
    "URL": "messi-lionel",
    "IMAGE": "https://www.flashscore.com/res/image/data/d8SZZtZg-S4hzKKkP.png",
    "PARTICIPANT_TYPE_ID": 2,
    "GENDER_ID": 1,
    "NAME": "Messi Lionel (Inter Miami)",
    "COUNTRY_NAME": "Argentina",
    "TITLE": "Messi Lionel (Inter Miami)"
  }
]

---

Sports Endpoints

Sports List

Get a list of all available sports.

Endpoint: GET /v1/sports/list

Description: Get a list of sports

Example Request:

GET /v1/sports/list

Example Response:

{
  "DATA": [
    {"ID": 1, "NAME": "SOCCER"},
    {"ID": 2, "NAME": "TENNIS"},
    {"ID": 3, "NAME": "BASKETBALL"}
  ]
}

Sports Events Count

Get data about the sport and the number of sport events.

Endpoint: GET /v1/sports/events-count

Description: Get data about the sport and the number of sport events

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
timezone	integer	Yes	Timezone offset (-12 to 12)

---

Events Endpoints

Events List

Get a list of events by sport ID and date.

Endpoint: GET /v1/events/list

Description: Get a list of events by sport_id. STAGE_TYPE - main event status, STAGE - more event status.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
timezone	integer	Yes	Timezone offset (-12 to 12)
indent_days	integer	Yes	Days from current date (-7 to +7), e.g., -1 for yesterday

Example Request:

GET /v1/events/list?locale=en_GB&sport_id=1&timezone=0&indent_days=0

Example Response:

{
  "DATA": [
    {
      "NAME": "England: Premier League",
      "HEADER": "England: Premier League;187;OEEq9Yvp",
      "NAME_PART_1": "England",
      "NAME_PART_2": "Premier League",
      "TOURNAMENT_TEMPLATE_ID": "dYlOSQOD",
      "COUNTRY_ID": 198,
      "COUNTRY_NAME": "England",
      "TOURNAMENT_STAGE_ID": "OEEq9Yvp",
      "TOURNAMENT_ID": "KKay4EE8",
      "EVENTS": [
        {
          "EVENT_ID": "0jR7cwU6",
          "START_TIME": 1773691200,
          "STAGE_TYPE": "FINISHED",
          "STAGE": "FINISHED",
          "ROUND": "Round 30",
          "HOME_NAME": "Brentford",
          "HOME_SCORE_CURRENT": "2",
          "AWAY_NAME": "Wolves",
          "AWAY_SCORE_CURRENT": "2"
        }
      ]
    }
  ],
  "LAST_CHANGE_KEY": "9354b7e973a15a0b3b744d5dc60ac108"
}

Events Data

Get detailed data about a specific event.

Endpoint: GET /v1/events/data

Description: Get all event data by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Request:

GET /v1/events/data?locale=en_GB&event_id=0jR7cwU6

Example Response:

{
  "DATA": {
    "EVENT": {
      "EVENT_ID": "0jR7cwU6",
      "START_TIME": 1773691200,
      "STAGE_TYPE": "FINISHED",
      "STAGE": "FINISHED",
      "ROUND": "Round 30",
      "HOME_NAME": "Brentford",
      "HOME_SCORE_CURRENT": "2",
      "AWAY_NAME": "Wolves",
      "AWAY_SCORE_CURRENT": "2"
    },
    "TOURNAMENT": {
      "NAME": "England: Premier League",
      "TOURNAMENT_STAGE_ID": "OEEq9Yvp",
      "COUNTRY_NAME": "England"
    },
    "SPORT": {
      "SPORT_ID": 1
    }
  },
  "LAST_CHANGE_KEY": "16ed35c82fc3a3bea4f7f5dc12bf2ac1"
}

Events Brief

Get brief data by event ID.

Endpoint: GET /v1/events/brief

Description: Get brief data by event ID. It is better to use Event Details and Event Data Brief endpoints.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Details

Get extended event details (Beta).

Endpoint: GET /v1/events/details

Description: Get event details by event ID (Beta endpoint)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Statistics

Get statistics for a specific event.

Endpoint: GET /v1/events/statistics

Description: Get event statistics by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Request:

GET /v1/events/statistics?locale=en_GB&event_id=0jR7cwU6

Example Response:

{
  "DATA": [
    {
      "STAGE_NAME": "Match",
      "GROUPS": [
        {
          "GROUP_LABEL": "Top stats",
          "ITEMS": [
            {
              "INCIDENT_NAME": "Expected goals (xG)",
              "VALUE_HOME": "2.56",
              "VALUE_AWAY": "1.33"
            },
            {
              "INCIDENT_NAME": "Ball possession",
              "VALUE_HOME": "50%",
              "VALUE_AWAY": "50%"
            }
          ]
        }
      ]
    }
  ]
}

Events Statistics Alt

Get event statistics by event ID (darts).

Endpoint: GET /v1/events/statistics-alt

Description: Get event statistics by event ID (darts)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Lineups

Get starting lineups for a specific event.

Endpoint: GET /v1/events/lineups

Description: Get starting lineups by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": [
    {
      "FORMATION_NAME": "Starting Lineups",
      "FORMATIONS": [
        {
          "FORMATION_LINE": 1,
          "FORMATION_DISPOSTION": "1-4-1-4-1",
          "MEMBERS": [
            {
              "PLAYER_ID": "4AmU39Qm",
              "PLAYER_FULL_NAME": "Collins N. (C)",
              "SHORT_NAME": "Collins",
              "PLAYER_NUMBER": 22,
              "PLAYER_COUNTRY": 96,
              "PLAYER_POSITION_ID": 1,
              "INCIDENTS": [1]
            }
          ]
        }
      ]
    }
  ]
}

Events Predicted Lineups

Get event predicted lineups by event ID.

Endpoint: GET /v1/events/predicted-lineups

Description: Get event predicted lineups by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Summary

Get a summary of events (goals, cards, substitutions) for a match.

Endpoint: GET /v1/events/summary

Description: Get summary of the event by event ID. Incidents of the match

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": [
    {
      "STAGE_NAME": "1st Half",
      "RESULT_HOME": "2",
      "RESULT_AWAY": "1",
      "ITEMS": [
        {
          "INCIDENT_ID": "bVQDKkEr",
          "INCIDENT_TEAM": 1,
          "INCIDENT_TIME": "22'",
          "INCIDENT_PARTICIPANTS": [
            {
              "INCIDENT_TYPE": "GOAL",
              "HOME_SCORE": "1",
              "AWAY_SCORE": "0",
              "PARTICIPANT_NAME": "Kayode M.",
              "INCIDENT_NAME": "Goal"
            }
          ]
        }
      ]
    }
  ],
  "INFO": {
    "REFEREE": "Attwell S.",
    "VENUE": "Brentford Community Stadium (London)",
    "ATTENDANCE": "17 155"
  }
}

Events Summary Incidents

Get event summary incidents by event ID.

Endpoint: GET /v1/events/summary-incidents

Description: Get event summary incidents by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Summary Results

Get event summary results by event ID.

Endpoint: GET /v1/events/summary-results

Description: Get event summary results by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Commentary

Get a comment on an event by event ID.

Endpoint: GET /v1/events/commentary

Description: Get a comment on an event by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Commentary Alt (Cricket)

Get a comment on an event (cricket) by event ID.

Endpoint: GET /v1/events/commentary-alt

Description: Get a comment on an event (cricket) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Odds

Get betting odds for a specific event.

Endpoint: GET /v1/events/odds

Description: Get odds by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": [
    {
      "BETTING_TYPE": "*1X2",
      "PERIODS": [
        {
          "ODDS_STAGE": "*Full Time",
          "GROUPS": [
            {
              "MARKETS": [
                {
                  "BOOKMAKER_ID": 16,
                  "BOOKMAKER_NAME": "bet365",
                  "ODD_CELL_FIRST": {"MOVE": "d", "VALUE": 1.53},
                  "ODD_CELL_SECOND": {"MOVE": "u", "VALUE": 4.33},
                  "ODD_CELL_THIRD": {"MOVE": "s", "VALUE": 5.75}
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Events Live Odds

Get live odds by event ID.

Endpoint: GET /v1/events/live-odds

Description: Get live odds by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID
book_id	integer	Yes	Bookmaker ID (e.g., 453 = 1xbet, 16 = bet365), range: 1-1000

Events Prematch Odds

Get event prematch odds by event ID.

Endpoint: GET /v1/events/prematch-odds

Description: Get event prematch odds by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
event_id	string	Yes	Event ID

Events List Main Odds

Get a list of main odds by sport and date.

Endpoint: GET /v1/events/list-main-odds

Description: Get a list of main odds by sport and date

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
timezone	integer	Yes	Timezone offset (-12 to 12)
indent_days	integer	Yes	Days from current date (-7 to +7)

Events Highlights (Video)

Get video highlights for an event.

Endpoint: GET /v1/events/highlights

Description: Get highlights video by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": [
    {
      "PROPERTY_LINK": "http://www.youtube.com/watch?v=...",
      "PROPERTY_TITLE": "Match highlights",
      "PROPERTY_SOURCE": "YouTube",
      "PROPERTY_IS_TOP": 1,
      "IMAGES": [
        {
          "HIGH": "740",
          "PROPERTY_IMAGE_URL": "https://..."
        }
      ]
    }
  ]
}

Events Last-Change

Get a hash of changed data keys for an event.

Endpoint: GET /v1/events/last-change

Description: Get new data keys. Call this point to see what data has been changed.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": {
    "COMMON": "a6855a5272555ec53d20ca6cfb3cae03",
    "SUMMARY": "87400baac8baad7fa804134f36bb674d",
    "STATISTICS": "6b83284ff46086fb660d06feb1b60790",
    "LINEUPS": "e7ae88ad7a97ff99e01e68e7615d1a06"
  }
}

Events H2H (Head-to-Head)

Get head-to-head history between teams.

Endpoint: GET /v1/events/h2h

Description: Get events between two teams by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Example Response:

{
  "DATA": [
    {
      "TAB_NAME": "Overall",
      "GROUPS": [
        {
          "GROUP_LABEL": "Last matches: Brentford",
          "ITEMS": [
            {
              "START_TIME": 1773691200,
              "EVENT_ID": "0jR7cwU6",
              "EVENT_NAME": "Premier League",
              "HOME_PARTICIPANT": "Brentford",
              "AWAY_PARTICIPANT": "Wolves",
              "CURRENT_RESULT": "2:2",
              "H_RESULT": "DRAW"
            }
          ]
        }
      ]
    }
  ]
}

Events Live List

Get list of live events.

Endpoint: GET /v1/events/live-list

Description: Get list of live events. Use /live-update to get changes in live events!

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
timezone	integer	Yes	Timezone offset (-12 to 12)

Events Live Update

Get a list of live event IDs that have changed.

Endpoint: GET /v1/events/live-update

Description: Get only new data into live-events by sport_id. Call every 5 seconds.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)

Example Response:

{
  "DATA": [
    {
      "EVENT_ID": "GWBtNZOF",
      "HAS_LINEPS": 1,
      "HAS_LIVE_CENTRE": 1
    }
  ]
}

Events Report

Get an event report by event ID.

Endpoint: GET /v1/events/report

Description: Get an event report by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events News

Get news by event ID.

Endpoint: GET /v1/events/news

Description: Get news by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Missing Players

Get all missing players by event ID.

Endpoint: GET /v1/events/missing-players

Description: Get all missing players by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Player Stats

Get event Player stats by event ID.

Endpoint: GET /v1/events/player-stats

Description: Get event Player stats by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Player Statistics Alt (Basketball)

Get player statistics by event ID (basketball).

Endpoint: GET /v1/events/player-statistics-alt

Description: Get player statistics by event ID (basketball)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Points History

Get the history of points by event ID (Point by Point).

Endpoint: GET /v1/events/points-history

Description: Get the history of points by event ID. Point by Point

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Ball-by-Ball (Cricket)

Get a ball by ball on an event (cricket) by event ID.

Endpoint: GET /v1/events/ball-by-ball

Description: Get a ball by ball on an event (cricket) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Scorecard (Cricket)

Get a scorecard on an event (cricket) by event ID.

Endpoint: GET /v1/events/scorecard

Description: Get a scorecard on an event (cricket) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Fall of Wickets (Cricket)

Get a fall of wickets on an event (cricket) by event ID.

Endpoint: GET /v1/events/fall-of-wickets

Description: Get a fall of wickets on an event (cricket) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events Throw-by-Throw (Darts)

Get throw by throw (darts) by event ID.

Endpoint: GET /v1/events/throw-by-throw

Description: Get throw by throw (darts) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
event_id	string	Yes	Event ID

Events No Duel Data (Golf)

Data on the No-duel event (golf).

Endpoint: GET /v1/events/no-duel-data

Description: Data on the No-duel event (golf)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
no_duel_event_id	string	Yes	No duel event ID
event_id	string	Yes	Event ID

Events Rounds Results (Golf)

Rounds results (golf) by event ID.

Endpoint: GET /v1/events/rounds-results

Description: Rounds results (golf) by event ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
no_duel_event_id	string	Yes	No duel event ID
event_id	string	Yes	Event ID

Events Racing Details (Horse Racing)

Racing details (HORSE_RACING).

Endpoint: GET /v1/events/racing-details

Description: Racing details (HORSE_RACING)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
timezone	integer	Yes	Timezone offset (-12 to 12)
tournament_template_id	string	Yes	Tournament template ID

---

Tournaments Endpoints

Tournaments List

Get a list of tournaments by sport.

Endpoint: GET /v1/tournaments/list

Description: Get a list of tournaments by sport ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)

Example Request:

GET /v1/tournaments/list?locale=en_GB&sport_id=1

Example Response:

{
  "DATA": [
    {
      "LEAGUE_NAME": "Premier League",
      "COUNTRY_NAME": "England",
      "COUNTRY_ID": 198,
      "ACTUAL_TOURNAMENT_SEASON_ID": "KKay4EE8",
      "GROUP_ID": "dYlOSQOD",
      "SEASON_ID": 187,
      "TEMPLATE_ID": "198_dYlOSQOD",
      "STAGES": [
        {
          "STAGE_ID": "OEEq9Yvp",
          "STAGE_NAME": "Main",
          "OUT": "1"
        }
      ]
    }
  ]
}

Tournaments Popular

Get a list of popular tournaments by sport ID.

Endpoint: GET /v1/tournaments/popular

Description: Get a list of popular tournaments by sport ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code

Tournaments Stages

Get a list of stages by sport ID.

Endpoint: GET /v1/tournaments/stages

Description: Get a list of stages by sport ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)

Tournaments Stages Data

Get detailed data about a tournament stage.

Endpoint: GET /v1/tournaments/stages/data

Description: Get tournament data by tournament_stage_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
tournament_stage_id	string	Yes	Tournament stage ID

Example Response:

{
  "DATA": {
    "COUNTRY_ID": 198,
    "COUNTRY_NAME": "England",
    "LEAGUE_NAME": "Premier League",
    "SEASON_ID": 187,
    "TEMPLATE_ID": "198_dYlOSQOD",
    "PART_SEASON_ID": "KKay4EE8",
    "TOURNAMENT_IMAGE": "https://...",
    "SEASONS": [
      {
        "SEASON_NAME": "2025/2026",
        "SEASON_ID": "KKay4EE8",
        "SEASON_TOURNAMENT_STAGE_ID": "OEEq9Yvp"
      }
    ]
  }
}

Tournaments Stages Seasons

Get seasons by stage_id (football).

Endpoint: GET /v1/tournaments/stages/seasons

Description: Get seasons by stage_id (football)

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
tournament_stage_id	string	Yes	Tournament stage ID

Tournaments Season Data

Get season data by season_id.

Endpoint: GET /v1/tournaments/seasons/data

Description: Get season data by season_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
season_id	string	Yes	Season tournament ID

Tournaments Standings

Get standings/tables for a tournament.

Endpoint: GET /v1/tournaments/standings

Description: Get tournament tables

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
standing_type	string	Yes	Standing type
tournament_stage_id	string	Yes	Tournament stage ID
tournament_season_id	string	Yes	Season tournament ID

Tournaments Standings Tabs

Get the available types (tabs) of standings.

Endpoint: GET /v1/tournaments/standings/tabs

Description: Get the available types (tabs) of standings

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
tournament_stage_id	string	Yes	Tournament stage ID
tournament_season_id	string	Yes	Season tournament ID

Tournaments Fixtures

Get upcoming fixtures for a tournament.

Endpoint: GET /v1/tournaments/fixtures

Description: Get upcoming events by tournament_stage_id. Use the pagination.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
tournament_stage_id	string	Yes	Tournament stage ID
page	integer	No	Page number (1-1000)

Tournaments Results

Get past results for a tournament (archive from 1990).

Endpoint: GET /v1/tournaments/results

Description: Get team results by tournament_stage_id. Use the pagination.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
tournament_stage_id	string	Yes	Tournament stage ID
page	integer	No	Page number (1-1000)

---

Teams Endpoints

Teams Data

Get detailed information about a team.

Endpoint: GET /v1/teams/data

Description: Get team data by team ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
team_id	string	Yes	Team ID

Example Request:

GET /v1/teams/data?locale=en_GB&sport_id=1&team_id=xYe7DwID

Example Response:

{
  "DATA": {
    "ID": "xYe7DwID",
    "SHORT_NAME": "Brentford",
    "GENDER_ID": 1,
    "COUNTRY_ID": 198,
    "COUNTRY_NAME": "England",
    "IMAGE_PATH": "https://www.flashscore.com/res/image/data/bBj3NWfM-r9Mudk7j.png",
    "NAME": "Brentford",
    "TYPE_ID": 1,
    "TYPE_NAME": "team",
    "PARENT_NAME": "Brentford FC",
    "TVN": "Brentford Community Stadium",
    "TTN": "London",
    "TVC": "17 250",
    "SPORT_ID": 1
  }
}

Teams Squad

Get the squad/roster for a team.

Endpoint: GET /v1/teams/squad

Description: Get squad by team ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
team_id	string	Yes	Team ID

Example Response:

{
  "DATA": [
    {
      "GROUP_ID": 12,
      "GROUP_LABEL": "Goalkeepers",
      "ITEMS": [
        {
          "PLAYER_ID": "4f3afj1b",
          "PLAYER_NAME": "Balcombe Ellery",
          "PLAYER_TYPE_ID": "GOALKEEPER",
          "PLAYER_JERSEY_NUMBER": 31,
          "PLAYER_FLAG_ID": 198,
          "PLAYER_IMAGE_PATH": "https://..."
        }
      ]
    }
  ]
}

Teams Fixtures

Get upcoming events by team ID.

Endpoint: GET /v1/teams/fixtures

Description: Get upcoming events by team ID. Use the pagination.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
team_id	string	Yes	Team ID
page	integer	No	Page number (1-1000)

Teams Results

Get team results by team ID.

Endpoint: GET /v1/teams/results

Description: Get team results by team ID. Use the pagination.

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
team_id	string	Yes	Team ID
page	integer	No	Page number (1-1000)

Teams Transfers

Get team transfers by team ID.

Endpoint: GET /v1/teams/transfers

Description: Get team transfers by team ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
team_id	string	Yes	Team ID
page	integer	No	Page number (1-1000)

Teams News

Get a list of news by team ID.

Endpoint: GET /v1/teams/news

Description: Get a list of news by team ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
team_id	string	Yes	Team ID

---

Players Endpoints

Players Data

Get detailed information about a player.

Endpoint: GET /v1/players/data

Description: Get player data by player ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
player_id	string	Yes	Player ID

Example Request:

GET /v1/players/data?locale=en_GB&sport_id=1&player_id=4f3afj1b

Example Response:

{
  "DATA": {
    "ID": "4f3afj1b",
    "SHORT_NAME": "Balcombe E.",
    "GENDER_ID": 1,
    "COUNTRY_ID": 198,
    "COUNTRY_NAME": "England",
    "IMAGE_PATH": "https://...",
    "NAME": "Ellery Balcombe",
    "BIRTHDAY_TIME": "939945600",
    "TYPE_ID": 12,
    "TYPE_NAME": "goalkeeper",
    "PARENT_NAME": "Brentford",
    "PMV": "€369k",
    "TEAM_ID": "xYe7DwID",
    "TEAM_NAME": "Brentford",
    "SPORT_ID": 1
  }
}

Players Career

Get player career by player ID.

Endpoint: GET /v1/players/career

Description: Get player career by player ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
player_id	string	Yes	Player ID

Players Transfers

Get transfer history for a player.

Endpoint: GET /v1/players/transfers

Description: Get the latest player transfers by player ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
player_id	string	Yes	Player ID

Example Response:

{
  "DATA": [
    {
      "TRANSFER_REASON": "return from loan",
      "TRANSFER_DATE": "2025",
      "FROM_TEAM_ID": "YuW7ZfMM",
      "FROM_TEAM_NAME": "Motherwell",
      "FROM_TEAM_LOGO": "https://...",
      "TO_TEAM_ID": "xYe7DwID",
      "TO_TEAM_NAME": "Brentford",
      "TO_TEAM_LOGO": "https://..."
    }
  ]
}

Players Last Events

Get the latest player events by player ID.

Endpoint: GET /v1/players/last-events

Description: Get the latest player events by player ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)
player_id	string	Yes	Player ID

Players Alt Events

Get the player events by player ID.

Endpoint: GET /v1/players/alt-events

Description: Get the player events by player ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
player_id	string	Yes	Player ID
sport_id	integer	Yes	Sport ID (1-42)
page	integer	No	Page number (0-1000)

---

Rankings Endpoints

Rankings List

Get a list of available rankings by sport.

Endpoint: GET /v1/rankings/list

Description: Get a list of ranking by sport ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
sport_id	integer	Yes	Sport ID (1-42)

Example Request:

GET /v1/rankings/list?locale=en_GB&sport_id=2

Example Response:

{
  "DATA": [
    {"RANKING_ID": "dSJr14Y8", "RANKING_LABEL": "ATP Singles"},
    {"RANKING_ID": "hfDiar3L", "RANKING_LABEL": "WTA Singles"},
    {"RANKING_ID": "4KeVObqb", "RANKING_LABEL": "ATP Singles Race"},
    {"RANKING_ID": "fgMkMdTG", "RANKING_LABEL": "WTA Singles Race"}
  ]
}

Rankings Data

Get ranking data by ranking ID.

Endpoint: GET /v1/rankings/data

Description: Get a ranking data by ranking ID

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
ranking_id	string	Yes	Ranking ID (use Ranking list endpoint)

---

News Endpoints

News Categories

Get categories of news.

Endpoint: GET /v1/news/categories

Description: Get categories of news

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code

News List

Get list of news by category_id and entity_id.

Endpoint: GET /v1/news/list

Description: Get list of news by category_id and entity_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
category_id	integer	Yes	Category ID (1-999), use News categories endpoint
entity_id	string	Yes	Entity ID, use News categories endpoint
page	integer	No	Page number (0-100)

News Top List

Get list of top news.

Endpoint: GET /v1/news/top

Description: Get list of top news

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code

News Most Read

Get the most read news.

Endpoint: GET /v1/news/most-read

Description: Get the most read news

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code

News Summary

Get brief information about the news by article_id.

Endpoint: GET /v1/news/summary

Description: Get brief information about the news by article_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
article_id	string	Yes	Article ID

News Details

Get detailed information about the news by article_id.

Endpoint: GET /v1/news/details

Description: Get detailed information about the news by article_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
article_id	string	Yes	Article ID

News Related

Get related news by article_id.

Endpoint: GET /v1/news/related

Description: Get related news by article_id

Parameters:

Name	Type	Required	Description
locale	string	Yes	Language code
article_id	string	Yes	Article ID

---

Images Endpoints

Images Data

Get a image player, team, tournament by IMAGE_ID.

Endpoint: GET /v1/images/data

Description: Get a image player, team, tournament by IMAGE_ID

Parameters:

Name	Type	Required	Description
image_id	string	Yes	Image ID

---

Common Workflows

Workflow 1: Building a Live Score App

1. Get sports list -> /v1/sports/list
2. Get today's events -> /v1/events/list (indent_days=0)
3. Poll for live updates -> /v1/events/live-update
4. For changed events, get details -> /v1/events/data

Workflow 2: Getting Match Details

1. Get event list -> /v1/events/list
2. Get event data -> /v1/events/data
3. Get lineups -> /v1/events/lineups
4. Get statistics -> /v1/events/statistics
5. Get summary -> /v1/events/summary

Workflow 3: Tournament Information

1. Get tournaments list -> /v1/tournaments/list
2. Get tournament stages -> /v1/tournaments/stages/data
3. Get standings -> /v1/tournaments/standings
4. Get fixtures -> /v1/tournaments/fixtures
5. Get results -> /v1/tournaments/results

---

Real-Time Updates

Using LAST_CHANGE_KEY

Each response includes a LAST_CHANGE_KEY hash. Compare this value with previous requests to detect changes.

Using Event Last-Change

The /v1/events/last-change endpoint returns hashes for different data categories:

{
  "DATA": {
    "COMMON": "hash1",
    "SUMMARY": "hash2",
    "STATISTICS": "hash3",
    "LINEUPS": "hash4",
    "PLAYER_STATISTICS": "hash5",
    "HIGHLIGHTS": "hash6"
  }
}

If STATISTICS hash changes, call /v1/events/statistics to get updated data.

Using Live-Update

The /v1/events/live-update endpoint returns only the event IDs that have changed for a sport:

{
  "DATA": [
    {"EVENT_ID": "GWBtNZOF", "HAS_LIVE_CENTRE": 1}
  ]
}

---

Data Types & Status Codes

Event Stage Types

Code	Status
1	SCHEDULED
2	LIVE
3	FINISHED

Event Stages

Code	Stage
1	SCHEDULED
2	LIVE
3	FINISHED
4	POSTPONED
5	CANCELED
6	EXTRA_TIME
7	PENALTIES
12	FIRST_HALF
13	SECOND_HALF
14	FIRST_PERIOD
15	SECOND_PERIOD
16	THIRD_PERIOD
17-21	FIRST_SET - FIFTH_SET
22-25	FIRST_QUARTER - FOURTH_QUARTER
26-35	FIRST_INNING - EXTRA_INNING
38	HALF_TIME
42	PENDING
43	DELAYED
44	SUSPENDED

Incident Types

Code	Type
1	YELLOW_CARD
2	RED_CARD
3	GOAL
4	OWN_GOAL
5	PENALTY_KICK
6	SUBSTITUTION_OUT
7	SUBSTITUTION_IN
8	ASSISTANCE
10	PENALTY_SCORED
11	PENALTY_MISSED

Participant Types

Code	Type
1	TEAM
2	PLAYER
12	GOALKEEPER
13	DEFENDER
14	MIDFIELDER
15	FORWARD
27	COACH

---

Best Practices

1. Caching

• Store LAST_CHANGE_KEY values to avoid unnecessary data transfers
• Only fetch updated data when hashes change

2. Rate Limiting

• Do not poll /v1/events/list for score updates
• Use /v1/events/live-update for real-time changes
• Use /v1/events/last-change for granular updates

3. Time Calculations

For sports like soccer, calculate match time yourself:

current_time = current_timestamp - period_start_time

4. Historical Data

• Use /v1/tournaments/results for match archives (back to 1990)
• Use /v1/tournaments/fixtures for future matches beyond 7 days

5. Image Handling

• Team/player images are provided via URLs
• Download flags from: Download flags image

---

Error Handling

HTTP Status Codes

Code	Description
200	Success
422	Validation Error
429	Rate Limit Exceeded
500	Server Error

Error Response Format

{
  "detail": [
    {
      "loc": ["query", "parameter_name"],
      "msg": "error message",
      "type": "error_type"
    }
  ]
}

---

FAQ

How often is data updated?

There is no delay in updating data. Use the /v1/events/live-update and /v1/events/last-change endpoints for real-time updates instead of polling the events list.

How do I get match times in soccer?

Calculate the time yourself by subtracting the period start time from the current time. This is standard practice for all sports APIs.

How do I get matches beyond 7 days?

• For future matches: Use /v1/tournaments/fixtures
• For historical matches: Use /v1/tournaments/results (archive back to 1990)

What sports are covered?

The API covers 30+ sports including Soccer, Tennis, Basketball, Hockey, Cricket, Esports, and many more. Use /v1/sports/list to get the full list.

---

Additional Resources

• Official Documentation: https://flashlive.rapi.one/
• OpenAPI Specification: Flashlive-sports OpenApi Specification
• Other Sport APIs: https://rapi.one/sports/
• .NET Package: https://github.com/tbm0115/FlashLive

---

Countries Reference

The API uses country IDs for filtering. Here are some common ones:

ID	Country
198	England
81	Germany
77	France
176	Spain
98	Italy
139	Netherlands
145	Norway
200	USA
22	Argentina
39	Brazil

For a complete list of countries and regions, refer to the List_Countries.md file.

---