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 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
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
​

API References - Previous

Demo response files

Next - API References

API Rate limiting

Last modified 4mo ago

Export as PDF

Copy link

Outline

Fixture status definitions

Event type definition

VAR-events type definition

Weather types

Pitch types

League types

Common standing rules

Formations