// Discipline of a season
Discipline of a season
Results plan and up
Players with the most red cards, 2 minute suspensions and yellow cards in a competition and season.
GEThttps://api.handballapi.com/v1/competitions/{id}/discipline
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.
Parameters3
| name | type | what it does | |
|---|---|---|---|
id | string | required | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
limit | integer | optional | How many rows, 1 to 200 (25) |
Returns9 fields
| field | type | what it holds |
|---|---|---|
rank | integer | Place in the list, from 1. |
player_id | string | Our id for the player (pl_). Permanent. |
name | string | The name as published. |
team_id | string|null | Our id for the team (tm_). Permanent. |
team | string|null | home or away. |
matches | integer | Matches with a line for the player. |
yellow | integer | Yellow cards. |
two_min | integer | 2 minute suspensions. |
red | integer | Red cards. |
Example answerGET /v1/competitions/cp_vdaq0xgv/discipline?season=2026%2F27
20025 of 25 rows
{
"data": [
{
"rank": 1,
"player_id": "pl_4dvcmymm",
"name": "Lena Boettcher",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 0,
"two_min": 3,
"red": 0
},
{
"rank": 2,
"player_id": "pl_4da324ga",
"name": "Johanna Teresa Lohre",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"yellow": 1,
"two_min": 2,
"red": 0
},
{
"rank": 3,
"player_id": "pl_2vsbp0hb",
"name": "Lenja Stranegger",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"yellow": 1,
"two_min": 2,
"red": 0
},
{
"rank": 4,
"player_id": "pl_ksbkfv8y",
"name": "Leni Schmidt",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 2,
"red": 0
},
{
"rank": 5,
"player_id": "pl_zz49ahyt",
"name": "Anna Hering",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 0,
"two_min": 2,
"red": 0
},
{
"rank": 6,
"player_id": "pl_aeqr40cr",
"name": "Sophie Kahlert",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"yellow": 0,
"two_min": 2,
"red": 0
},
{
"rank": 7,
"player_id": "pl_mmm1anec",
"name": "Lotta Elisa Dietrich",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"yellow": 1,
"two_min": 1,
"red": 0
},
{
"rank": 8,
"player_id": "pl_1s918x7p",
"name": "Melanie Franz",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"yellow": 1,
"two_min": 1,
"red": 0
},
{
"rank": 9,
"player_id": "pl_6wc4bc9a",
"name": "Laura Janzen",
"team_id": "tm_m6y101yy",
"team": "SOESTER TV VON 1862 E.V.",
"matches": 1,
"yellow": 1,
"two_min": 1,
"red": 0
},
{
"rank": 10,
"player_id": "pl_5q9zf0kq",
"name": "Chiara Lunau",
"team_id": "tm_m32520sc",
"team": "Allgemeiner Sportverein Hamm-Westfalen e.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 11,
"player_id": "pl_q1n2kvpj",
"name": "Stella Voigt",
"team_id": "tm_yxwkzkkn",
"team": "HSG Soest Damen",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 12,
"player_id": "pl_7r111z1p",
"name": "Juliane Förster",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 13,
"player_id": "pl_0mynry3y",
"name": "Elena Schulte",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 14,
"player_id": "pl_x866c4xm",
"name": "Carla Lichte",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 15,
"player_id": "pl_7v8q4tp9",
"name": "Lara Kristin Bimpage",
"team_id": "tm_m6y101yy",
"team": "SOESTER TV VON 1862 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 16,
"player_id": "pl_tq65081z",
"name": "Elisa Ante",
"team_id": "tm_m6y101yy",
"team": "SOESTER TV VON 1862 E.V.",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 17,
"player_id": "pl_k4hvh3ad",
"name": "Lotte Karolina Bergsen",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 18,
"player_id": "pl_dydxr4xm",
"name": "Leonie Loos",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 19,
"player_id": "pl_69b547f6",
"name": "Bianca Wahlbrink",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 20,
"player_id": "pl_tvm3hk6z",
"name": "Lucie Höllein",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 21,
"player_id": "pl_s8ydn2hb",
"name": "Kristin Wortmann",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 1,
"yellow": 0,
"two_min": 1,
"red": 0
},
{
"rank": 22,
"player_id": "pl_7ye5c00z",
"name": "Sarah Michelle Klostermeier",
"team_id": "tm_vm7h9pbf",
"team": "LÜNER SV HANDBALL E.V. II",
"matches": 1,
"yellow": 1,
"two_min": 0,
"red": 0
},
{
"rank": 23,
"player_id": "pl_53e2f3am",
"name": "Nele Schuetz",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"yellow": 1,
"two_min": 0,
"red": 0
},
{
"rank": 24,
"player_id": "pl_p8qz7xfm",
"name": "Pia Sandhof",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 1,
"two_min": 0,
"red": 0
},
{
"rank": 25,
"player_id": "pl_sspbn5zm",
"name": "Melanie Harnischmacher",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"yellow": 1,
"two_min": 0,
"red": 0
}
],
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"compiled_at": "2026-10-31T03:40:01Z",
"count": 25,
"took_ms": 7
}
}