Physical Performance API (1.0)

Download OpenAPI specification:

Provides foundational data for tracking game occurrences and possession details plus detailed event metadata categorized by event type and player performance grades.

Games

Get games list

Returns the list of games.

query Parameters

season	string Example: season=2024-2025 Season filter
competition_id	integer Example: competition_id=1 Competition id filter
team_id	integer Example: team_id=1 Team id filter (matches team or opponent)

Responses

Response samples

200

Content type

application/json

{"data": {"games": [{"competition": {"id": 1,
"name": "competition name"
},
"date": "2025-06-09",
"id": 1,
"opponentTeam": {"id": 2,
"name": "opponent team name"
},
"season": "2024-2025",
"stadium": {"length": 123,
"name": "stadium name",
"width": 123
},
"team": {"id": 1,
"name": "team name"
},
"teamExtraTimeStartSide": "Left",
"teamStartSide": "Left",
"venueType": "TEAM_HOME"
}
]
}
}

Get flatten game events

Returns the list of flatten game events.

path Parameters

id

required

integer

Example: 123

Game id

Responses

Response samples

200

Content type

application/json

{"data": {"gameEvents": [{"away_players": [{"confidence": "MEDIUM",
"jerseyNum": "7",
"player": {"id": 2,
"name": "Jane Smith"
},
"speed": 22.3,
"visibility": "ESTIMATED",
"x": 2.67,
"y": 10.22
}
],
"balls": [{"visibility": "VISIBLE",
"x": 2.67,
"y": 10.22,
"z": 0.02
}
],
"competitionId": 1,
"eventType": "FIRSTKICKOFF",
"eventTypeDescription": "FIRSTKICKOFF",
"gameId": 2,
"homeTeam": false,
"home_players": [{"confidence": "HIGH",
"jerseyNum": "12",
"player": {"id": 1,
"name": "John Doe"
},
"speed": 25.5,
"visibility": "VISIBLE",
"x": 2.67,
"y": 10.22
}
],
"id": 1,
"period": 1,
"periodDescription": "First half",
"player": {"id": 1,
"name": "Player Name"
},
"season": "2024-2025",
"startFormattedGameClock": "00:01",
"startGameClock": 123,
"team": {"id": 1,
"name": "Team Name"
}
}
]
}
}

Get game events

Returns the list of game events.

path Parameters

id

required

integer

Example: 123

Game id

Responses

Response samples

200

Content type

application/json

{"data": {"gameEvents": [{"competitionId": 1,
"earlyDistribution": false,
"endType": "1",
"endTypeDescription": "End of First Half",
"gameEventType": "FIRSTKICKOFF",
"gameEventTypeDescription": "FIRSTKICKOFF",
"gameId": 2,
"homeTeam": false,
"id": 1,
"initialNonEvent": false,
"outType": "A",
"outTypeDescription": "Away Score",
"period": 1,
"periodDescription": "First half",
"player": {"id": 1,
"name": "Player Name"
},
"playerOff": {"id": 1,
"name": "Off Player Name"
},
"playerOffType": "I",
"playerOffTypeDescription": "Injury",
"playerOn": {"id": 2,
"name": "On Player Name"
},
"possessionEvents": [{"ballCarryTouchEvents": [{"ballCarrierPlayer": {"id": 1001,
"name": "John Doe"
},
"ballCarryOutcome": "R",
"ballCarryOutcomeDescription": "Retains",
"carryDefenderPlayer": {"id": 1003,
"name": "Bob Johnson"
},
"carryIntent": "E",
"carryIntentDescription": "Escape Pressure",
"carrySuccessful": true,
"carryType": "D",
"carryTypeDescription": "Drive with intent",
"id": 1,
"touchOutcomeType": "C",
"touchOutcomeTypeDescription": "Challenge",
"touchPlayer": {"id": 1002,
"name": "Jane Smith"
},
"touchType": "P",
"touchTypeDescription": "Failed pass"
}
],
"ballHeightType": "G",
"ballHeightTypeDescription": "On the ground",
"bodyType": "RF",
"bodyTypeDescription": "Right foot",
"challengeEvents": [{"additionalDuelers": [{"id": 1005,
"name": "Charlie Davis"
}
],
"awayDuelPlayer": {"id": 1003,
"name": "Bob Johnson"
},
"carrierPlayer": {"id": 1001,
"name": "John Doe"
},
"challengeKeeperPlayer": {"id": 1006,
"name": "Sam Wilson"
},
"challengeOutcomeType": "K",
"challengeOutcomeTypeDescription": "Keeps ball with contact",
"challengeType": "D",
"challengeTypeDescription": "Dribble",
"challengeWinnerPlayer": {"id": 1001,
"name": "John Doe"
},
"challengerPlayer": {"id": 1003,
"name": "Bob Johnson"
},
"challengers": [{"id": 1003,
"name": "Bob Johnson"
},
{"id": 1004,
"name": "Alice Williams"
}
],
"dribbleType": "T",
"dribbleTypeDescription": "Trick",
"dribblerPlayer": {"id": 1002,
"name": "Jane Smith"
},
"homeDuelPlayer": {"id": 1001,
"name": "John Doe"
},
"id": 1,
"tackleAttemptType": "G",
"tackleAttemptTypeDescription": "Defender attempts to win the ball",
"trickType": "stepover"
}
],
"clearanceEvents": [{"clearanceOutcomeType": "O",
"clearanceOutcomeTypeDescription": "Out of Play",
"clearancePlayer": {"id": 1001,
"name": "John Doe"
},
"id": 1
}
],
"endGameClock": 123,
"grades": [{"dribbler": {"grade": 6,
"playerId": 1,
"playerName": "Dribbler Player"
},
"awayDuel": {"grade": 6,
"playerId": 2,
"playerName": "Away Duel Player"
},
"ballCarrier": {"grade": 6,
"playerId": 1,
"playerName": "Ball Carrier Player"
},
"challengeKeeper": {"grade": 6,
"playerId": 1,
"playerName": "Challenge Keeper Player"
},
"additionalDuelers": [{"grade": 1,
"playerId": 4,
"playerName": "Additional Dueler"
}
],
"positions": [{"grade": 6,
"playerId": 2,
"playerName": "Position"
}
],
"failedCrosser": {"grade": 6,
"playerId": 1,
"playerName": "Failed Crosser Player"
},
"deflector": {"grade": 6,
"playerId": 1,
"playerName": "Deflector Player"
},
"failedPasser": {"grade": 6,
"playerId": 1,
"playerName": "Failed Passer Player"
},
"blocker": {"grade": 6,
"playerId": 1,
"playerName": "Blocker Player"
},
"closingDowns": [{"grade": 6,
"playerId": 2,
"playerName": "Closing Down"
}
],
"movements": [{"grade": 6,
"playerId": 2,
"playerName": "Movement"
}
],
"homeDuel": {"grade": 6,
"playerId": 1,
"playerName": "Home Duel Player"
},
"carrier": {"grade": 6,
"playerId": 1,
"playerName": "Carrier Player"
},
"cs": {"grade": 6.5,
"playerId": 10,
"playerName": "CS Player"
},
"failedShooter": {"grade": 6,
"playerId": 1,
"playerName": "Failed Shooter Player"
},
"disciplines": [{"grade": 6,
"playerId": 2,
"playerName": "Discipline"
}
],
"target": {"grade": 6,
"playerId": 9,
"playerName": "Target Player"
},
"clearer": {"grade": 6,
"playerId": 1,
"playerName": "Clearer Player"
},
"dabs": [{"grade": 6,
"playerId": 2,
"playerName": "Dab"
}
],
"csVs": {"grade": 6,
"playerId": 11,
"playerName": "CS VS Player"
},
"keeper": {"grade": 6,
"playerId": 5,
"playerName": "Keeper Player"
},
"passer": {"grade": 6,
"playerId": 6,
"playerName": "Passer Player"
},
"defender": {"grade": 6,
"playerId": 3,
"playerName": "Defender Player"
},
"receiver": {"grade": 6,
"playerId": 7,
"playerName": "Receiver Player"
},
"challengers": [{"grade": 6,
"playerId": 2,
"playerName": "Challenger"
}
],
"shooter": {"grade": 6,
"playerId": 8,
"playerName": "Shooter Player"
},
"failedClearer": {"grade": 6,
"playerId": 1,
"playerName": "Failed Clearer Player"
},
"failedBlockers": [{"grade": 6,
"playerId": 7,
"playerName": "Failed Blocker"
}
],
"carryDefender": {"grade": 6,
"playerId": 3,
"playerName": "Carry Defender Player"
},
"glClearer": {"grade": 6,
"playerId": 1,
"playerName": "GL Clearer Player"
},
"touch": {"grade": 6,
"playerId": 12,
"playerName": "Touch Player"
},
"crosser": {"grade": 6,
"playerId": 1,
"playerName": "Crosser Player"
}
}
],
"highPointType": "L",
"highPointTypeDescription": "Off the ground but below waist",
"id": 1,
"nonEvent": false,
"passCrossEvents": [{"accuracyType": "P",
"accuracyTypeDescription": "Precise",
"crossOutcomeType": "C",
"crossOutcomeTypeDescription": "Complete",
"crossType": "F",
"crossTypeDescription": "Floated",
"crossZoneType": "C",
"crossZoneTypeDescription": "Central",
"crosserPlayer": {"id": 1005,
"name": "Alex Brown"
},
"defenderPlayer": {"id": 1003,
"name": "Bob Williams"
},
"failedBlockers": [{"id": 1004,
"name": "Mike Davis"
}
],
"id": 1,
"linesBrokenType": "M",
"linesBrokenTypeDescription": "Midfield",
"passOutcomeType": "C",
"passOutcomeTypeDescription": "Complete",
"passType": "S",
"passTypeDescription": "Standard Pass",
"passerPlayer": {"id": 1001,
"name": "John Smith"
},
"receiverFacingType": "G",
"receiverFacingTypeDescription": "Goal",
"receiverPlayer": {"id": 1002,
"name": "James Johnson"
},
"targetFacingType": "G",
"targetFacingTypeDescription": "Goal",
"targetPlayer": {"id": 1002,
"name": "James Johnson"
}
}
],
"period": 1,
"periodDescription": "First half",
"player": {"id": 1,
"name": "Player Name"
},
"possessionEventType": "PA",
"possessionEventTypeDescription": "Pass",
"pressureEvents": [{"directionType": "F",
"directionTypeDescription": "Forwards",
"id": 1,
"pressurePlayer": {"id": 1001,
"name": "John Doe"
},
"pressureType": "P",
"pressureTypeDescription": "Player Pressured"
}
],
"reboundEvents": [{"id": 1,
"originateType": "P",
"originateTypeDescription": "Player",
"reboundOutcomeType": "R",
"reboundOutcomeTypeDescription": "Retain",
"rebounderPlayer": {"id": 1001,
"name": "John Smith"
}
}
],
"shootingEvents": [{"badParry": false,
"ballMoving": true,
"bodyMovementType": "TG",
"bodyMovementTypeDescription": "Moving towards goal",
"clearerPlayer": {"id": 1003,
"name": "Bob Williams"
},
"id": 1,
"keeperTouchType": "2H",
"keeperTouchTypeDescription": "Two hands",
"saveHeightType": "1",
"saveHeightTypeDescription": "BOTTOMTHIRD",
"saveReboundType": "MA",
"saveReboundTypeDescription": "Into the middle area",
"saveable": true,
"saverPlayer": {"id": 1002,
"name": "James Johnson"
},
"shooterPlayer": {"id": 1001,
"name": "John Smith"
},
"shotInitialHeightType": "G",
"shotInitialHeightTypeDescription": "Ground",
"shotNatureType": "P",
"shotNatureTypeDescription": "Power",
"shotOutcomeType": "S",
"shotOutcomeTypeDescription": "Save on target",
"shotType": "F",
"shotTypeDescription": "Side Foot"
}
],
"startFormattedGameClock": "00:01",
"startGameClock": 123,
"team": {"id": 1,
"name": "Team Name"
}
}
],
"season": "2024-2025",
"setpieceType": "C",
"setpieceTypeDescription": "Corner Kick",
"startFormattedGameClock": "00:01",
"startGameClock": 123,
"subType": "H",
"subTypeDescription": "Head Injury",
"team": {"id": 1,
"name": "Team Name"
},
"touches": 123,
"touchesInBox": 12,
"videoMissing": false,
"videoUrl": "http://link-to-video.com"
}
]
}
}

Get high speed runs

Returns the list of high speed runs.

path Parameters

id

required

integer

Example: 123

Game id

Responses

Response samples

200

Content type

application/json

{"data": {"highSpeedRuns": [{"competition": {"id": 1,
"name": "competition name"
},
"distance": 1,
"gameDate": "2025-06-09",
"gameId": 1,
"id": "1",
"opponentTeam": {"id": 2,
"name": "opponent team name"
},
"period": 1,
"periodElapsedTimeEnd": 1,
"periodElapsedTimeStart": 1,
"periodGameClockTimeEnd": 1,
"periodGameClockTimeStart": 1,
"player": {"id": 1,
"name": "player name"
},
"position": "position",
"runTime": 1,
"season": "2024-2025",
"shirtNumber": 1,
"speedKmh": 1,
"started": true,
"team": {"id": 1,
"name": "team name"
},
"videoEndAt": 1,
"videoStartAt": 1,
"videoUrl": "video url",
"xEnd": 1,
"xStart": 1,
"yEnd": 1,
"yStart": 1
}
]
}
}

Gets the physical metrics for a game

path Parameters

id

required

integer

Example: 123

Game id

Request Body schema: application/json
required

Physical metrics filters

possessions

Array of strings (Possession)

Items Enum: "IN" "OUT" "ALL" "NONE"

Responses

Request samples

Payload

Content type

application/json

{"possessions": ["IN"
]
}

Response samples

200

Content type

application/json

{"data": [{"competition": {"id": 1,
"name": "La Liga"
},
"gameDate": "2021-09-01",
"location": "HOME",
"metrics": [{"name": "total_distance",
"raw": 10000,
"rawPercentile": 75
},
{"name": "sprints",
"raw": 25,
"rawPercentile": 65
}
],
"opponentTeam": {"id": 1,
"name": "Inter"
},
"player": {"id": 1,
"name": "playerName"
},
"playerPosition": "GK",
"possession": "IN",
"season": "2021",
"team": {"id": 1,
"name": "teamName"
}
}
]
}

Get sprints

Returns the list of sprints.

path Parameters

id

required

integer

Example: 123

Game id

Responses

Response samples

200

Content type

application/json

{"data": {"sprints": [{"competition": {"id": 1,
"name": "competition name"
},
"distance": 1,
"gameDate": "2025-06-09",
"gameId": 1,
"id": "1",
"opponentTeam": {"id": 2,
"name": "opponent team name"
},
"period": 1,
"periodElapsedTimeEnd": 1,
"periodElapsedTimeStart": 1,
"periodGameClockTimeEnd": 1,
"periodGameClockTimeStart": 1,
"player": {"id": 1,
"name": "player name"
},
"position": "position",
"runTime": 1,
"season": "2024-2025",
"shirtNumber": 1,
"speedKmh": 1,
"started": true,
"team": {"id": 1,
"name": "team name"
},
"videoEndAt": 1,
"videoStartAt": 1,
"videoUrl": "video url",
"xEnd": 1,
"xStart": 1,
"yEnd": 1,
"yStart": 1
}
]
}
}

Physical metrics

Gets the physical metrics for a game

Request Body schema: application/json
required

Physical metrics filters

	object (Age) Age
competitionIds	Array of integers Competition IDs
	object or null (GroupAndFilter) Filters
positions	Array of strings (Position) Items Enum: "GK" "D" "CB" "LB" "RB" "LWB" "RWB" "LCB" "RCB" "MCB" "CDM" "M" "DM" "CM" "AM" "CAM" "LM" "RM" "LW" "RW" "CF" "ST" "F"
possession	string (Possession) Enum: "IN" "OUT" "ALL" "NONE"
seasons	Array of strings Seasons
teamIds	Array of integers Team IDs

Responses

Request samples

Payload

Content type

application/json

{"age": {"from": 18,
"to": 23
},
"competitionIds": [18
],
"filters": {"and": [{"operator": "values_between",
"subject": "total_distance",
"values": [18,
23
]
},
{"operator": "gt",
"subject": "game_appearances",
"value": 18
},
{"operator": "above_median",
"subject": "sprints"
}
]
},
"positions": ["GK"
],
"possession": "IN",
"season": "2020",
"teamIds": [25
]
}

Response samples

200

Content type

application/json

{"data": [{"age": 25,
"firstName": "firstName",
"id": 1,
"lastName": "lastName",
"metrics": [{"name": "total_distance",
"p90": 12000,
"p90Percentile": 80,
"raw": 10000,
"rawPercentile": 75
},
{"name": "sprints",
"p90": 30,
"p90Percentile": 70,
"raw": 25,
"rawPercentile": 65
}
],
"playedHistory": [{"competition_id": 1,
"competition_name": "competition name",
"position": "GK",
"season": "season",
"team_id": 1,
"team_name": "team name"
}
],
"position": "GK",
"team": {"id": 1,
"name": "team name"
}
}
]
}

Players

Get players list

Returns the list of players.

Responses

Response samples

200

Content type

application/json

{"data": {"players": [{"athleticismScore": 12.3,
"dob": "2025-06-09",
"firstName": "John",
"id": 1,
"lastName": "Doe",
"name": "John Doe",
"nickname": "nickname",
"position": "position",
"shirtNumber": "1",
"team": {"id": 1,
"name": "team name"
},
"transfermarktPlayerId": 2
}
]
}
}

Gets the physical metrics for a player

path Parameters

id

required

integer

Example: 123

Players id

Request Body schema: application/json
required

Physical metrics filters

competitionIds	Array of integers non-empty
possessions	Array of strings (Possession) non-empty Items Enum: "IN" "OUT" "ALL" "NONE"
seasons	Array of strings non-empty
teamIds	Array of integers non-empty

Responses

Request samples

Payload

Content type

application/json

{"competitionIds": [1
],
"possessions": ["IN"
],
"seasons": ["2022"
],
"teamIds": [1
]
}

Response samples

200

Content type

application/json

{"data": [{"competition": {"id": 1,
"name": "La Liga"
},
"gameDate": "2021-09-01",
"gameId": 1,
"location": "HOME",
"metrics": [{"name": "total_distance",
"raw": 10000,
"rawPercentile": 75
},
{"name": "sprints",
"raw": 25,
"rawPercentile": 65
}
],
"opponentTeam": {"id": 1,
"name": "Inter"
},
"playerPosition": "GK",
"possession": "IN",
"season": "2021",
"team": {"id": 1,
"name": "teamName"
}
}
]
}

Application Status

Get application status

Returns the current status of the application.

Responses

Response samples

200

Content type

application/json

{"data": {"status": "ok"
}
}

Physical Performance API (1.0)

Games

Get games list

query Parameters

Responses

Response samples

Get flatten game events

path Parameters

Responses

Response samples

Get game events

path Parameters

Responses

Response samples

Get high speed runs

path Parameters

Responses

Response samples

Gets the physical metrics for a game

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get sprints

path Parameters

Responses

Response samples

Physical metrics

Gets the physical metrics for a game

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Players

Get players list

Responses

Response samples

Gets the physical metrics for a player

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Application Status

Get application status

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required