Statuses & Definitions

Introduction

On this page we will show you some game definitions.

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.
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 Cancelled The game has been cancelled.
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.
AWARDED Awarded Winner is beeing decided externally.
DELAYED Delayed The game is delayed so it wil start later.
TBA To Be Announced Fixture will be updated with exact time 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 definitions

We host several events related to a fixture. Find below the event types with description or their meaning.

Definition Explanation
goal A goal has been scored.
penalty Penalty has been scored.
missed_penalty Penalty has been missed (* only available for major leagues).
own-goal Own goal
var Information about VAR events like cancelled goals etc.
yellowcard Yellowcard is given for player
yellowred 2nd yellow card for player resulting in red card.
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 missed.

Formations

Below you can find a list of possible lineup formations

3-1-4-2 3-2-4-1 3-3-1-3 3-3-3-1 3-4-1-2 3-4-2-1
3-4-3 3-5-1-1 3-5-2 4-1-2-3 4-1-3-2 4-1-4-1
4-2-2-2 4-2-3-1 4-2-4 4-3-1-2 4-3-2-1 4-3-3
4-4-1-1 4-4-2 4-2-4 4-5-1 5-2-3 5-3-2
5-4-1

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 Explanation
clear-sky
few-clouds
scattered-clouds
broken-clouds
shower-rain
rain
thunderstorm
snow
mist

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 Explanation
Good
Wet
Wet and Fast
Artificial Turf
Regular
Excellent
Snowy
Slow due to water
Uneven and|cutting up
Hard and Frozen

Questions?

We're always happy to help with code or other questions you might have! Search our documentation, contact support, or get in touch with our sales team.

This article was last updated on 2019-01-17 14:33:58

{{ loginForm.errors.get('email') }}

{{ loginForm.errors.get('password') }}

Remember me?
Sign in with GitHub

Products

Company

Docs & Help

Get In Touch

Social Media

Powered by Stripe