// Matches of a player
Matches of a player
Results plan and up
Every match a player has a line for, newest first, with the line: goals, shots, 7m, assists, suspensions, saves.
GEThttps://api.handballapi.com/v1/players/{id}/matches
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.
Parameters4
| name | type | what it does | |
|---|---|---|---|
id | string | required | Player id (pl_...) |
per_page | integer | optional | Rows per page, 1 to 200 (100) |
page | integer | optional | Page number, from 1. Wins over cursor |
cursor | string | optional | The next_cursor from the previous answer |
Returns10 fields
| field | type | what it holds |
|---|---|---|
id | string | Our id for the record. Permanent. |
date_utc | datetime | Throw-off in UTC, ending Z. |
kickoff_local | datetime|null | Throw-off in the league's own time, with its offset; null where only the date is published or the match is international. |
timezone | string|null | The league's time zone (IANA name), or null for international and history rows. |
status | string | finished, or awarded when the result was given at the table. |
competition | object | id (cp_), name, country and season, such as 2026/27. |
home | object | team_id (tm_), name, goals, and ht: goals at half-time, null where not published. |
away | object | The same for the away team. |
team | string | home or away. |
line | object |
Example answerGET /v1/players/pl_4stewt2m/matches?per_page=3
2002 of 2 rows
{
"data": [
{
"id": "mt_r42fra39",
"date_utc": "2026-10-30T20:30:00Z",
"kickoff_local": "2026-10-30T21:30:00+01:00",
"timezone": "Europe/Berlin",
"status": "finished",
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"season": "2026/27"
},
"home": {
"team_id": "tm_pd7mgxmj",
"name": "HSG HOHENLIMBURG II",
"goals": 20,
"ht": null
},
"away": {
"team_id": "tm_vkcq92se",
"name": "SGH Unna Massen",
"goals": 29,
"ht": null
},
"team": "home",
"line": {
"goals": 5,
"shots": null,
"seven_m_goals": 4,
"seven_m_shots": 4,
"assists": null,
"two_min": 0,
"saves": null,
"shots_faced": null
}
},
{
"id": "mt_cr5s548c",
"date_utc": "2026-10-11T17:00:00Z",
"kickoff_local": "2026-10-11T19:00:00+02:00",
"timezone": "Europe/Berlin",
"status": "finished",
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"season": "2026/27"
},
"home": {
"team_id": "tm_m6y101yy",
"name": "SOESTER TV VON 1862 E.V.",
"goals": 31,
"ht": null
},
"away": {
"team_id": "tm_pd7mgxmj",
"name": "HSG HOHENLIMBURG II",
"goals": 25,
"ht": null
},
"team": "away",
"line": {
"goals": 7,
"shots": null,
"seven_m_goals": 4,
"seven_m_shots": 7,
"assists": null,
"two_min": 0,
"saves": null,
"shots_faced": null
}
}
],
"meta": {
"count": 2,
"next_cursor": null,
"page": 1,
"per_page": 3,
"total": 2,
"total_pages": 1,
"next_page": null,
"prev_page": null,
"player_id": "pl_4stewt2m",
"took_ms": 16
}
}