Passes

The Passes resources provide access to individual statistical data related to passing actions in a football match.

Directions

GET /v1/stats/passes/directions/(lineupID)

The Passes/Directions subresource allows you to access individual statistical data on passes made in a given direction during in a football match. We assume that a team will move from its own goal toward their its opponent’s goal. Some passes are played forward and toward a flank; in these situations two fields would be updated.

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.
pass_forward integer Total number of passes played toward opponent’s goal.
pass_backward integer Total number of passes played toward own goal.
pass_left integer Total number of passes played toward left touch line.
pass_right integer Total number of passes played toward right touch line.
OPTIONS /v1/stats/passes/directions

Returns documentation of the Passes/Directions subresource.

Lengths

GET /v1/stats/passes/lengths/(lineupID)

The Passes/Lengths subresource allows you to access individual statistical data on the performance of passing actions of varying lengths in a football 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.
short_success integer Total number of short passes that are successfully controlled by a teammate.
short_failure integer Total number of short passes that are unsuccessfully controlled by a teammate.
long_success integer Total number of long passes that are successfully controlled by a teammate.
long_failure integer Total number of long passes that are successfully controlled by a teammate.
flickon_success integer Total number of flick-on passes that are successfully controlled by a teammate.
flickon_failure integer Total number of flick-on passes that are unsuccessfully controlled by a teammate.
OPTIONS /v1/stats/passes/lengths

Returns documentation of the Passes/Lengths subresource.

Locations

GET /v1/stats/passes/locations/(lineupID)

The Passes/Locations subresource allows you to access individual statistical data on successful and unsuccessful passes in a football match initiated from various sectors of the pitch. 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.
ownhalf_success integer Total number of passes from own half that are successfully controlled by a teammate.
ownhalf_failure integer Total number of passes from own half that are unsuccessfully controlled by a teammate.
opphalf_success integer Total number of passes from opposition half that are successfully controlled by a teammate.
opphalf_failure integer Total number of passes from opposition half that are unsuccessfully controlled by a teammate.
defthird_success integer Total number of passes from defensive third that are successfully controlled by a teammate.
defthird_failure integer Total number of passes from defensive third that are unsuccessfully controlled by a teammate.
midthird_success integer Total number of passes from middle third that are successfully controlled by a teammate.
midthird_failure integer Total number of passes from middle third that are unsuccessfully controlled by a teammate.
finthird_success integer Total number of passes from final third that are successfully controlled by a teammate.
finthird_failure integer Total number of passes from final third that are unsuccessfully controlled by a teammate.
OPTIONS /v1/stats/passes/locations

Returns documentation of the Passes/Locations subresource.

Totals

GET /v1/stats/passes/totals/(lineupID)

The Passes/Totals subresource allows you to access individual statistical data on cumulative passing actions made by a player in a football 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.
total_success integer Total number of passes that are successfully controlled by a teammate.
total_failure integer Total number of passes that are unsuccessfully controlled by a teammate.
total_no_cc_success integer Total number of successful passes, excluding crosses that result from corners.
total_no_cc_failure integer Total number of unsuccessful passes, excluding crosses that result from corners.
longball_success integer Total number of successful long passes (30 meters or more).
longball_failure integer Total number of unsuccessful long passes (30 meters or more).
layoffs_success integer Total number of successful lay-off passes.
layoffs_failure integer Total number of unsuccessful lay-off passes.
throughballs integer Total number of passes between a group of defenders toward a teammate.
keypasses integer Total number of passes deemed “key” to buildup or team strategy.
OPTIONS /v1/stats/passes/totals

Returns documentation of the Passes/Totals subresource.