# Statuses and definitions ## Fixture status 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 | ## Event type definition We host several events related to a fixture. Find below the event types with the description or their meaning.
Event typeExplanation
Event typeExplanation
goalA goal has been scored
penaltyPenalty has been scored
missed_penaltyPenalty has been missed
own-goalOwn goal
varInformation about VAR events like canceled goals etc
yellowcardYellow card is given for a player
yellowredSecond yellow card for player resulting in a red
redcardDirect red card
substitutionA player got substituted and new player got in
pen_shootout_goalPenalty in penalty shootout has been scored
pen_shootout_missPenalty in penalty shootout has been scored
## VAR-events type definition 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 types 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` | ## Pitch types 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 types | 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 | ## Common standing rules | 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 | ## Formations 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