Statuses and definitions
A fixtures moves between several statuses. It has an initial status, can be delayed, has been finished or any of the statuses described below.
Definition | Explanation | Information |
NS | Not Started | The initial status of a game |
LIVE | Live | The game is currently inplay |
HT | Half-Time | The game currently is in half-time |
FT | Full-Time | The game has ended after 90 minutes. When a game goes into extra time, the FT status will be presented for a few seconds and then move to the BREAK status. |
ET | Extra-Time | The game currently is in extra time, can happen in knockout games |
PEN_LIVE | Penalty Shootout | ET status didn't get a winner, penalties are taken to determine the winner |
AET | Finished after extra time | The game has finished after 120 minutes |
BREAK | Regular time finished | Waiting for extra time or penalties to start |
FT_PEN | Full-Time after penalties | Finished after penalty shootout |
CANCL | Canceled | The game has been canceled |
POSTP | PostPoned | The game has been postponed |
INT | Interrupted | The game has been interrupted. Can be due to bad weather |
ABAN | Abandoned | The game has abandoned and will continue at a later time or day |
SUSP | Suspended | The game has 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 or something |
Deleted | Deleted | Game is not available anymore via normal 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 |
We host several events related to a fixture. Find below the event types with the description or their meaning.
Event type | Explanation |
goal | A goal has been scored |
penalty | Penalty has been scored |
missed_penalty | Penalty has been missed |
own-goal | Own goal |
var | Information about VAR events like canceled goals etc |
yellowcard | Yellow card is given for a player |
yellowred | Second yellow card for player resulting in a red |
redcard | Direct red card |
substitution | A player got substituted and new player got in |
pen_shootout_goal | Penalty in penalty shootout has been scored |
pen_shootout_miss | Penalty in penalty shootout has been scored |
At the moment we have the var events
Goal Disallowed
and Goal under review
. If there is a var check, the event type is set to the second one. When the check is over, the goal is disallowed or the event type is set to a goal.
Weather can be of great influence on the final result of a game or on the performance of the teams. A list of possible conditions is given below.
Code |
clear sky |
few clouds |
scattered clouds |
broken clouds |
shower rain |
rain |
thunderstorm |
snow |
mist |
clouds |
moderate rain |
haze |
light intensity shower rain |
light rain |
overcast clouds |
light intensity drizzle |
fog |
heavy intensity rain |
thunderstorm with light rain |
thunderstorm with rain |
light intensity drizzle |
drizzle |
heavy intensity drizzle |
light intensity drizzle rain |
drizzle rain |
heavy intensity drizzle rain |
shower rain and drizzle |
heavy shower rain and drizzle |
shower drizzle |
light snow |
snow |
heavy snow |
sleet |
light shower sleet |
shower sleet |
light rain and snow |
rain and snow |
light shower snow |
shower snow |
heavy shower snow |
The status of the pitch can also be of great influence on the final result of a game or on the performance of the teams. A list of possible conditions is given below.
Code |
Good |
Wet |
Wet and Fast |
Artificial Turf |
Regular |
Excellent |
Snowy |
Slow due to water |
Uneven and|cutting up |
Hard and Frozen |
League type | |
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 |
Standing rules |
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 lineups. We have listed the most common formations.
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-2 |
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-1 |
Last modified 1yr ago