// Handball player and goalkeeper stats API
Player lines of a match
Results plan and upMCP: match_players
A line for every player listed for the match: goals, shots, 7m, assists, cards, and saves and shots faced for goalkeepers.
GEThttps://api.handballapi.com/v1/matches/{id}/players
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Parameters2
| name | type | what it does | |
|---|---|---|---|
id | string | required | Match id (mt_...) |
team | string | optional | home or away homeaway |
Returns16 fields
| field | type | what it holds |
|---|---|---|
player_id | string | Our id for the player (pl_). Permanent. |
team | string | home or away. |
name | string | The name as published. |
shirt | string|null | Shirt number, where published. |
position | string|null | GK, LW, LB, CB, RB, RW or PV, where known. |
goals | integer|null | Goals scored. |
shots | integer|null | Shots taken, where published. |
seven_m_goals | integer|null | 7m throws scored. |
seven_m_shots | integer|null | 7m throws taken. |
assists | integer|null | Assists, where published. |
yellow | integer|null | Yellow cards. |
two_min | integer|null | 2 minute suspensions. |
red | integer|null | Red cards. |
saves | integer|null | Goalkeepers: saves. |
shots_faced | integer|null | Goalkeepers: shots faced. |
save_rate | number|null | Goalkeepers: saves divided by shots faced, 0 to 1. |
Example answerGET /v1/matches/mt_r42fra39/players?team=home
20015 of 15 rows
{
"data": [
{
"player_id": "pl_aeqr40cr",
"team": "home",
"name": "Sophie Kahlert",
"shirt": "2",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_4da324ga",
"team": "home",
"name": "Johanna Teresa Lohre",
"shirt": "5",
"position": null,
"goals": 4,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 1,
"two_min": 2,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_1d80vh19",
"team": "home",
"name": "Insa Schroth",
"shirt": "8",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_xqxwt7m9",
"team": "home",
"name": "Frida Dewenter",
"shirt": "9",
"position": null,
"goals": 2,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_2p8qcr8t",
"team": "home",
"name": "Selina Lutz",
"shirt": "13",
"position": null,
"goals": 1,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_2vsbp0hb",
"team": "home",
"name": "Lenja Stranegger",
"shirt": "14",
"position": null,
"goals": 1,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 1,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_59nvycrk",
"team": "home",
"name": "Ann Christin Kriwett",
"shirt": "22",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_4stewt2m",
"team": "home",
"name": "Jule Marie Pietzner",
"shirt": "27",
"position": null,
"goals": 5,
"shots": null,
"seven_m_goals": 4,
"seven_m_shots": 4,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_tvm3hk6z",
"team": "home",
"name": "Lucie Höllein",
"shirt": "28",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 1,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_qma43eqc",
"team": "home",
"name": "Nele Marie Bleicher",
"shirt": "34",
"position": null,
"goals": 4,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_wx9rj2p5",
"team": "home",
"name": "Sophia Geuss",
"shirt": "36",
"position": null,
"goals": 2,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_bbdkc40e",
"team": "home",
"name": "Dana Loreen Konopka",
"shirt": "37",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_gxp3mpnm",
"team": "home",
"name": "Liv Malin Segrewe",
"shirt": "45",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_4z1bgb2t",
"team": "home",
"name": "Sara Luettringhaus",
"shirt": "71",
"position": null,
"goals": 1,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 0,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
},
{
"player_id": "pl_s8ydn2hb",
"team": "home",
"name": "Kristin Wortmann",
"shirt": "77",
"position": null,
"goals": 0,
"shots": null,
"seven_m_goals": null,
"seven_m_shots": null,
"assists": null,
"yellow": 0,
"two_min": 1,
"red": 0,
"saves": null,
"shots_faced": null,
"save_rate": null
}
],
"meta": {
"match_id": "mt_r42fra39",
"count": 15,
"lines_check": {
"status": "adds_up"
},
"took_ms": 1
}
}