Football FAQs

Possible values of the status of a match

The following lists the possible values for the state of a match and its identifier statusId

0 Default (Not started)
1 First Half
2 Ended
3 Suspended
4 Postponed
5 Half Time
6 Second Half
7 End of Regular time
8 Extra Time 1
9 End Extra Time 1
10 Extra Time 2
11 End Extra Time 2
12 Penalty Shoot-Out

Possible Player Role/Position Values

The following lists the possible values for position attribute and its identifier positionId in <Player>

1 Goalkeeper
2 Defender
3 Midfielder
4 Foward
5 Coach / DT

Events: Values of type and typeId in the <Incidence>

Below is the list of possible values providing detailed information for minute-by-minute match tracking, including game stages, goals, yellow cards, and more.

1 Start of game
2 End of game
3 Yellow card
4 Red card through double yellow card
5 Red card
6 Substitution - On (disused)
7 Substitution
9 Field goal
10 Own goal
11 Headed goal
12 Goal from free kick
13 Goal from penalty kick
17 End of first half
18 Start of second half
28 Corner kick
29 Clearance
30 Clearance to corner
31 Penalty committed by foul
32 Penalty committed by hand ball
33 Shot off target
34 Shot on woodwork
35 Shot on goal
36 Foul committed
37 Hand ball
38 Save
39 Assist
40 Foul received
41 Penalty foul received
42 Saved penalty
43 Penalty saved
44 Penalty missed
45 Penalty on woodwork
46 Throw-in
47 Offside
48 Goal kick
49 End of second half
50 Start of extra time 1
51 End of extra time 1
52 Start of extra time 2
53 End of extra time 2
54 Start of penalty shoot-out
55 Goal in penalty shoot-out
56 Penalty saved in penalty shoot-out
57 Penalty missed in penalty shoot-out
58 Saves in penalty shoot-out
59 Decided by disciplinary court
60 Goal awarded by disciplinary court
180 Correct pass
181 Incorrect pass
182 Interception
183 Penalty on the post in penalty shoot-out
296 Danger situation
354 Free kick
402 Injury time added

Cards

The Match includes disciplinary events showing cards issued to players during a match. Each event contains information about the penalized player, the match minute, and optionally, the reason or description of the foul.

Three types of card events are supported.

The cards in the <Incidences> node

Yellow card: A yellow card is included in <incidence Incidence Type group="yellow Cards"> with these attributes:

card="Yellow"
type="Yellow card"
typeId="3"

Red card for double yellow: a second yellow card means a red card for double yellow card. This is included in two groups: <IncidenceType group="yellowCards"> and <IncidenceType group="redCards"> with these attributes:
- card="Red"
- type="Red card for double yellow" typeId="4"
- comment="Red card for double yellow"
Red card is included in <IncidenceType group="redCards"> with these attributes:

card="Red"
type="Red card" typeId="5"
comment="Red card for double yellow"

Card statistics are calculated according to the following rules

Yellow card (first):

Adds +1 to the player’s and team’s total yellow cards.

Second yellow card (double yellow):

A second yellow results in a sending-off (red card). This event is counted as follows:

The total yellow cards include the second yellow.

The total red cards also include the expulsion resulting from the double yellow.

Direct red card:

Adds +1 to the total red cards. Does not affect the total yellow cards.

Statistical interpretation in <PlayerStats>

The total red cards count includes expulsions due to a second yellow.

The total yellow cards count includes the second yellow that triggers the red card.

The red card issued due to a second yellow represents the compensating factor between both totals (i.e., it is not subtracted from yellow totals).

Example: A player receives two yellow cards but no direct red cards, yet accumulates one yellow card and one red card (for two yellow cards).

redCards="1"
redByDoubleYellowCard="1"
yellowCards="2"

Page updated

Report abuse