// Fixtures ahead
Fixtures ahead
Free key and every planMCP: fixtures
Matches scheduled in the coming days, soonest first, with throw-off in UTC and in the league's own time.
GEThttps://api.handballapi.com/v1/fixtures
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.
Parameters5
| name | type | what it does | |
|---|---|---|---|
days | integer | optional | How many days ahead, 1 to 14 (7) |
country | string | optional | Country code dksesihrcztrgrbrdeskrseschihfhistory |
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 |
Returns8 fields
| field | type | what it holds |
|---|---|---|
status | string | finished, or awarded when the result was given at the table. |
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. |
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. |
Example answerGET /v1/fixtures?days=7&per_page=3
2003 of 998 rows
{
"data": [
{
"id": "mt_5xv51fwn",
"date_utc": "2026-10-31T10:00:00Z",
"kickoff_local": "2026-10-31T11:00:00+01:00",
"timezone": "Europe/Prague",
"status": "scheduled",
"competition": {
"id": "cp_cb4zj230",
"name": "1. liga ženy",
"country": "cz",
"season": "2026/27"
},
"home": {
"team_id": "tm_9rna5pn4",
"name": "Házená Chebsko",
"goals": null,
"ht": null
},
"away": {
"team_id": "tm_02krbk9n",
"name": "TJ Loko České Budějovice",
"goals": null,
"ht": null
}
},
{
"id": "mt_e5x8cyq3",
"date_utc": "2026-10-31T10:00:00Z",
"kickoff_local": "2026-10-31T11:00:00+01:00",
"timezone": "Europe/Prague",
"status": "scheduled",
"competition": {
"id": "cp_3h9dyckq",
"name": "2. liga muži SM",
"country": "cz",
"season": "2026/27"
},
"home": {
"team_id": "tm_m4kmz7an",
"name": "T.J.Sokol Klimkovice A",
"goals": null,
"ht": null
},
"away": {
"team_id": "tm_wggkkh95",
"name": "TJ Holešov",
"goals": null,
"ht": null
}
},
{
"id": "mt_axdjg0m7",
"date_utc": "2026-10-31T10:00:00Z",
"kickoff_local": "2026-10-31T12:00:00+02:00",
"timezone": "Europe/Athens",
"status": "scheduled",
"competition": {
"id": "cp_p35e8781",
"name": "A2 Gynaikon",
"country": "gr",
"season": "2026/27"
},
"home": {
"team_id": "tm_0z88n76z",
"name": "ΦΑΙΑΚΑΣ ΚΕΡΚΥΡΑΣ",
"goals": null,
"ht": null
},
"away": {
"team_id": "tm_b7e0mvmq",
"name": "Α.Ο ΙΩΑΝΝΙΝΩΝ",
"goals": null,
"ht": null
}
}
],
"meta": {
"count": 3,
"next_cursor": "cDI",
"page": 1,
"per_page": 3,
"total": 998,
"total_pages": 333,
"next_page": 2,
"prev_page": null,
"days": 7,
"took_ms": 22
}
}