For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fixture statistics

All the statistics types available for a fixture.

These statistics can be included on a fixture using the statistics include, and filtered using the fixtureStatisticTypes filter.

Read more about including these statistics on a fixture in Team fixture statistics or about filtering them in Filtering team fixture statistics

Statistics and extra time

By default, include=statistics returns one cumulative total per team for the entire match, including extra time if the match went there. Regular time and extra time are not split out automatically.

For example, in a fixture that went to extra time, one team's Shots Total (42) was 3 in the first half, 4 in the second half, and 0 in extra time. The flat statistics include returned a single value of 7 for that team, the sum of all three periods.

If you need statistics broken down by match phase (first half, second half, extra time), use include=periods.statistics instead of the flat statistics include. Extra time is a single period (type_id: 3) unless you use detailedPeriods, which splits it into Extra Time 1st Half (type_id: 5314) and Extra Time 2nd Half (type_id: 39).

See Periods for the full breakdown and response shape.

ID
Code
Developer Name
Description

34

corners

CORNERS

Number of corners taken by each team in the match.

41

shots-off-target

SHOTS_OFF_TARGET

Number of shots by each team that missed the target in the match.

42

shots-total

SHOTS_TOTAL

Total number of shots taken by each team in the match.

43

attacks

ATTACKS

Number of attacks by each team in the match.

44

dangerous-attacks

DANGEROUS_ATTACKS

Number of dangerous attacks by each team in the match.

45

ball-possession

BALL_POSSESSION

Percentage of ball possession held by each team in the match.

46

ball-safe

BALL_SAFE

Number of times each team played the ball back to their own half in the match.

47

penalties

PENALTIES

Penalty kicks awarded/taken.

49

shots-insidebox

SHOTS_INSIDEBOX

Number of shots taken by each team from inside the box in the match.

50

shots-outsidebox

SHOTS_OUTSIDEBOX

Number of shots taken by each team from outside the box in the match.

51

offsides

OFFSIDES

Number of offsides called against each team in the match.

52

goals

GOALS

Number of goals scored by each team in the match.

53

goals-kicks

GOAL_KICKS

Number of goal kicks taken by each team in the match.

54

goal-attempts

GOAL_ATTEMPTS

Number of goal attempts made by each team in the match.

55

free-kicks

FREE_KICKS

Number of free kicks awarded to each team in the match.

56

fouls

FOULS

Number of fouls committed by each team in the match.

57

saves

SAVES

Number of saves made by each team's goalkeeper in the match.

58

shots-blocked

SHOTS_BLOCKED

Number of shots blocked, per team, in the match.

59

substitutions

SUBSTITUTIONS

Number of substitutions made by each team in the match.

60

throwins

THROWINS

Number of throw-ins taken by each team in the match.

62

long-passes

LONG_PASSES

Number of long passes attempted by each team in the match.

64

hit-woodwork

HIT_WOODWORK

Number of times each team hit the post or crossbar in the match.

65

successful-headers

SUCCESSFUL_HEADERS

Number of successful headers made by each team in the match.

66

successful-interceptions

SUCCESSFUL_INTERCEPTIONS

Number of successful interceptions made by each team in the match.

68

substitutions-overtime

SUBSTITUTIONS_OVERTIME

Number of substitutions made by each team during overtime in the match.

69

offsides-overtime

OFFSIDES_OVERTIME

Number of offsides called against each team during overtime in the match.

70

headers

HEADERS

Number of headers made by each team in the match.

74

yellowcards-overtime

YELLOWCARDS_OVERTIME

Number of yellow cards received by each team during overtime in the match.

77

challenges

CHALLENGES

Number of challenges made by each team in the match.

78

tackles

TACKLES

Number of tackles made by each team in the match.

79

assists

ASSISTS

Number of assists made by each team in the match.

80

passes

PASSES

Number of passes attempted by each team in the match.

81

successful-passes

SUCCESSFUL_PASSES

Number of successful passes made by each team in the match.

82

successful-passes-percentage

SUCCESSFUL_PASSES_PERCENTAGE

Percentage of successful passes made by each team in the match.

83

redcards

REDCARDS

Number of straight red cards received by each team in the match.

84

yellowcards

YELLOWCARDS

Number of yellow cards received by each team in the match.

85

yellowred-cards

YELLOWRED_CARDS

Number of second-yellow (yellow-red) cards received by each team in the match.

86

shots-on-target

SHOTS_ON_TARGET

Number of shots by each team that were on target in the match.

87

injuries

INJURIES

Number of injuries sustained by each team in the match.

98

total-crosses

TOTAL_CROSSES

Total number of crosses attempted by each team in the match.

99

accurate-crosses

ACCURATE_CROSSES

Number of accurate crosses made by each team in the match.

100

interceptions

INTERCEPTIONS

Number of interceptions made by each team in the match.

106

duels-won

DUELS_WON

Number of duels won by each team in the match.

108

dribble-attempts

DRIBBLED_ATTEMPTS

Number of dribble attempts made by each team in the match.

109

successful-dribbles

SUCCESSFUL_DRIBBLES

Number of successful dribbles made by each team in the match.

117

key-passes

KEY_PASSES

Number of key passes made by each team in the match.

580

big-chances-created

BIG_CHANCES_CREATED

Number of big chances created by each team in the match.

581

big-chances-missed

BIG_CHANCES_MISSED

Number of big chances missed by each team in the match.

1489

treatment

TREATMENTS

Number of on-pitch treatments received by each team in the match.

1527

counter-attacks

COUNTER_ATTACKS

Number of counter-attacks made by each team in the match.

1533

successful-crosses-percentage

SUCCESSFUL_CROSSES_PERCENTAGE

Percentage of successful crosses made by each team in the match.

1605

successful-dribbles-percentage

SUCCESSFUL_DRIBBLES_PERCENTAGE

Percentage of successful dribble attempts made by each team in the match.

27264

successful-long-passes

SUCCESSFUL_LONG_PASSES

Number of successful long passes made by each team in the match.

27265

successful-long-passes-percentage

SUCCESSFUL_LONG_PASSES_PERCENTAGE

Percentage of successful long passes made by each team in the match.

27267

tackles-won

TACKLES_WON

Number of tackles won by each team in the match.

Fixture Player Statistics

These statistics can be included on a fixture using the lineups.details nested include, and filtered using the lineupDetailTypes filter.

Read more about including these statistics on a fixture in Player fixture statistics or about filtering them in Filtering player fixture statistics

ID
Code
Developer Name
Description

40

captain

CAPTAIN

Indicates whether the player was the captain in the match.

41

shots-off-target

SHOTS_OFF_TARGET

Number of shots by the player that missed the target in the match.

42

shots-total

SHOTS_TOTAL

Total number of shots taken by the player in the match.

47

penalties

PENALTIES

Number of penalties taken by the player in the match.

51

offsides

OFFSIDES

Number of offsides called against the player in the match.

52

goals

GOALS

Number of goals scored by the player in the match.

56

fouls

FOULS

Number of fouls committed by the player in the match.

57

saves

SAVES

Number of saves made by the player (goalkeeper) in the match.

58

shots-blocked

SHOTS_BLOCKED

Number of the player's shots that were blocked in the match.

64

hit-woodwork

HIT_WOODWORK

Number of times the player hit the post or crossbar in the match.

78

tackles

TACKLES

Number of tackles made by the player in the match.

79

assists

ASSISTS

Number of assists made by the player in the match.

80

passes

PASSES

Number of passes attempted by the player in the match.

83

redcards

REDCARDS

Number of straight red cards received by the player in the match.

84

yellowcards

YELLOWCARDS

Number of yellow cards received by the player in the match.

85

yellowred-cards

YELLOWRED_CARDS

Number of second-yellow (yellow-red) cards received by the player in the match.

86

shots-on-target

SHOTS_ON_TARGET

Number of shots by the player that were on target in the match.

88

goals-conceded

GOALS_CONCEDED

Number of goals conceded while the player was on the pitch in the match.

96

fouls-drawn

FOULS_DRAWN

Number of fouls drawn by the player in the match.

97

blocked-shots

BLOCKED_SHOTS

Number of shots blocked by the player in the match.

98

total-crosses

TOTAL_CROSSES

Total number of crosses attempted by the player in the match.

99

accurate-crosses

ACCURATE_CROSSES

Number of accurate crosses made by the player in the match.

100

interceptions

INTERCEPTIONS

Number of interceptions made by the player in the match.

101

clearances

CLEARANCES

Number of clearances made by the player in the match.

104

saves-insidebox

SAVES_INSIDE_BOX

Number of saves made by the player inside the box in the match.

105

total-duels

TOTAL_DUELS

Total number of duels contested by the player in the match.

106

duels-won

DUELS_WON

Number of duels won by the player in the match.

107

aerials-won

AERIALS_WON

Number of aerial duels won by the player in the match.

108

dribble-attempts

DRIBBLED_ATTEMPTS

Number of dribble attempts made by the player in the match.

109

successful-dribbles

SUCCESSFUL_DRIBBLES

Number of successful dribbles made by the player in the match.

110

dribbled-past

DRIBBLED_PAST

Number of successful dribbles made by the player in the match.

116

accurate-passes

ACCURATE_PASSES

Number of accurate passes made by the player in the match.

117

key-passes

KEY_PASSES

Number of key passes made by the player in the match.

118

rating

RATING

The player's match rating for the match.

119

minutes-played

MINUTES_PLAYED

Number of minutes played by the player in the match.

120

touches

TOUCHES

Number of touches made by the player in the match.

121

turn-over

TURN_OVER

Number of times possession was lost by the player in the match.

122

long-balls

LONG_BALLS

Number of long balls attempted by the player in the match.

123

long-balls-won

LONG_BALLS_WON

Number of long balls won by the player in the match.

124

through-balls

THROUGH_BALLS

Number of through balls attempted by the player in the match.

125

through-balls-won

THROUGH_BALLS_WON

Percentage of through balls successfully completed by the player in the match.

581

big-chances-missed

BIG_CHANCES_MISSED

Number of big chances missed by the player in the match.

1491

duels-lost

DUELS_LOST

Number of duels lost by the player in the match.

1533

successful-crosses-percentage

SUCCESSFUL_CROSSES_PERCENTAGE

Percentage of the player's crosses that were successful in the match.

1584

accurate-passes-percentage

ACCURATE_PASSES_PERCENTAGE

Percentage of the player's passes that were accurate in the match.

1605

successful-dribbles-percentage

SUCCESSFUL_DRIBBLES_PERCENTAGE

Percentage of the player's dribble attempts that were successful in the match.

27267

tackles-won

TACKLES_WON

Number of tackles won by the player in the match.

Expected Goals (xG)

xG statistics are not included in the tables above. They are delivered through a separate include and belong to the Expected Goals add-on, not the standard statistics or lineups.details includes.

Scope
Include to use
Where the value appears

Team

xGFixture

xGFixture[].value

Player

lineups.xGLineup

lineups[].xGLineup[].value

For the full list of xG type IDs, see the Expected types page. For retrieval examples and filtering, see the Expected Goals tutorial.

Absent statistics and zero values

When a statistic type is absent from the statistics array, it is inconclusive. It can mean the metric was not tracked in that fixture, or that the result was genuinely zero. The API does not record 0 values in most cases, so absence alone does not tell you which of the two applies. This is common in lower leagues and for metrics that are not tracked in every competition.

Exception: card period statistics. If a fixture contains at least one card overall, all card period statistics are returned explicitly as 0 for every period, even periods where no cards were shown. For example, if a fixture has a second-half yellow card but no first-half yellow cards, the first-half yellow card statistic will still be present with value: 0 rather than absent. This means that for card period statistics specifically, a value: 0 can be taken as a confirmed zero.

The same applies to player statistics on lineups.details: an absent statistic is inconclusive between not tracked and zero, with the same card period exception applying.

Last updated

Was this helpful?