Welcome to our football data library. Here you will find all kinds of data fields and their definitions. We will include all statuses and definitions so you can have a perfect understanding of our Football API and the meaning of your data. You can also take a look at our documentation pages. After reading the information on this page, you will better understand our Football Database.
Every fixture has a status. There are a lot of different statuses a fixture can have and every fixture moves through different statuses. For example, a fixture will have the status NS, which means not starting before starting a game. After the referee’s first whistle, the fixture will have the status LIVE, which means that the match is playing at that moment. The match will get a new status ‘HT’ when the referee whistles for halftime. After the break, the game will be LIVE again until the referee whistles for Full Time. The status will be ‘FT’. However, there are many more possibilities. Let’s take a closer look at them in the list below.
NS Not Started. The initial status of a game. Every game has this status until the game gets started or Postponed.
LIVE Live. The game is currently inplay.
INPLAY_1ST_HALF 1st Half. The game is currently inplay in the 1st half.
HT Half-Time. The game is currently in the half-time break.
FT Full-Time. The game ended after 90 minutes. When a game goes into extra time, the FT status is presented for a few seconds and then switches to the BREAK status.
BREAK Regular time finished. Waiting for extra time (ET) or penalties (Pen_Live) to start.
ET Extra-Time. The game is currently in extra time. This can only happen in knockout games.
AET Finished After Extra Time. The game finished after 120 minutes.
Pen_Live Penalty Shootout. ET status didn’t get a winner. Penalties are taken to determine the winner
FT_PEN Full-Time after Penalties. Finished after the penalty shootout.
CANCL Canceled. The game has been canceled.
POSTP PostPoned. The game has been postponed.
INT Interrupted. The game has been interrupted. A reason for an interruption can be bad weather.
ABAN Abandoned. The game has been abandoned and will continue at a later time or day.
SUSP. Suspended. The game has been suspended and will continue at a later time or day.
TBA. To Be Announced. The game does not have a confirmed date and time yet. It will be announced later on.
AWARDED Awarded. Winner is being decided externally.
DELAYED Delayed. The game is delayed so it will start later.
WO Walk Over. Awarding of a victory to a contestant because there are no other contestants.
AU Awaiting Updates. Can occur when there is a connectivity issue.
DELETED. Deleted. The game is not available anymore via regular API calls because it has been replaced. This can happen in leagues that have a lot of changes in their schedules. The games can still be retrieved by adding deleted=1 to your request so you can update your system properly
The most important in football are the events during a game. There are various event types, like a goal, card substitution, etc. In the table below, you will find the types
The first time the Video Assistant Referee was introduced in football at a worldwide event was at the 2016 FIFA Club World Cup. On 16 March 2018, the FIFA Council approved using the VAR for the 2018 FIFA World Cup in Russia.
Due to the introduction of the VAR worldwide, we provide so-called VAR-event types. The types are: ‘Goal Disallowed’ and ‘Goal under review’.
If there is a VAR-check, the event type is set to the ‘Goal under review’. When the check is over, the event will be set to ‘Goal Disallowed’ or the event type will be set to ‘Goal’. This means that we don’t show which goals were under review after the goal was allowed.
Sportmonks differentiates a couple of different league types. A list of possible types can be found below.
Domestic A league from one country. I.e The English Premier League, Serie A, La Liga etc.
Domestic_cup A cup from one country. I.e The F.A Cup, DFB Pokal, Coppa Italia etc.
International A league for international teams. I.e World Cup, European Championship, Copa America
Cup_international An international cup. I.e UEFA Champions League, Copa Libertadores, UEFA Europa League
Play-offs A play-off league for a specific competition.
Friendly An international or club-friendly league. I.e Club Friendlies, International Friendlies.
Group-stage Indicates that the stage of the competition is the group stage.
Knock-out Indicates that the stage of the competition is the knock-out stage.
Qualifying Indicates that the stage of the competition is the qualifying stage.
Promotion, Relegation, Relegation Play-off, Relegation Round, Possible Relegation, Next Round, Final Series, Promotion Play-off, Promotion Group, Final, Semi-finals, UEFA Champions League, UEFA Champions League Qualifiers, UEFA Europa League, UEFA Europa League Qualifiers, Championship Round, Championship Play-off, 1st Phase, 2nd Phase, CONMEBOL Libertadores, CONMEBOL Libertadores Qualifiers, CONMEBOL Sudamericana, CONMEBOL Sudamericana Qualifiers.
Fixtures contain information about the participants’ line-ups. We have listed the most common formations.
4-2-3-1, 4-3-3, 4-4-2, 4-1-4-1, 3-5-2, 3-4-3, 4-3-1-2, 4-4-1-1, 3-4-2-1, 3-4-1-2, 5-3-2, 5-4-1, 4-5-1, 3-1-4, 4-2-2-2, 4-3-2-1, 3-5-1-1, 4-1-3-2, 4-1-2-3, 3-3-1-3, 3-3-3-1, 5-2-3, 4-2-4, 3-2-4-1, 4-2-1-3, 2-3-4-1, 5-2-2.
The 4-3-3 formation is the most common formation with four defenders, three midfielders and three attackers. Nowadays, 4-2-3-1 is a very popular formation used by coaches all over the world. The formation starts with four defenders at the back, two very defensive midfielders, three attacking midfielders and a striker.
We are proud to tell you we cover 100+ statistics due to our new API 3.0.
The number of statistics made it necessary to distribute them over our standard and advanced packages.
A list is created to display which stats are included in the standard and advanced packages so you can opt for the statistics you’re interested in while choosing your plan. You can find this list on our data features page or by clicking the button below.