Fouls

The Fouls resources provide access to individual statistical data related to induced fouls and disciplinary cards received in a football match.

Cards

GET /v1/stats/fouls/cards/(lineupID)

The Fouls/Cards subresource allows you to access individual statistical data on the number of disciplinary cards that a player receives in a match. If lineupID is passed, it returns statistical data for a player in the match lineup that lineupID corresponds to.

If query parameters are passed to the resource, it returns the players in the match lineup who match the specified filters.

Response Parameters:

Field Type Description
lineup uuid The unique ID of the player in match lineup.
yellows integer Number of yellow cards received by player in match.
reds integer Number of red or yellow/red cards received by player in match.
OPTIONS /v1/stats/fouls/cards

Returns documentation of the Fouls/Cards subresource.

Wins

GET /v1/stats/fouls/wins/(lineupID)

The Fouls/Wins subresource allows you to access individual statistical data on total number of fouls “won” by a player in a match, and the general areas of the pitch where they occurred.

(Americans might use the term “fouls suffered” or “drawn fouls” to borrow the basketball term.)

If lineupID is passed, it returns statistical data for a player in the match lineup that lineupID corresponds to.

If query parameters are passed to the resource, it returns the players in the match lineup who match the specified filters.

Response Parameters:

Field Type Description
lineup uuid The unique ID of the player in match lineup.
total integer Total number of fouls won by a player in match.
total_danger integer Total number of fouls won in area close to goal (excluding penalties).
total_penalty integer Total number of fouls won that earn a penalty kick.
total_nodanger integer Total number of fouls won in area far from goal.
OPTIONS /v1/stats/fouls/wins

Returns documentation of the Fouls/Wins subresource.