Endpoint Playground
Returns the matches of a competition's current matchday, of a numbered matchday (`matchday`, 1 to the competition's matchday count, reported as `matchday_count`) or of the matchday around a date. Each match has teams, date, kick-off time, score and status (`finished`, `scheduled` or `other` with a note). Cups and tournaments have no numbered matchdays. Dates, times and scores are decoded from the site's obfuscated glyph fonts.
curl 'https://api.crawlora.net/api/v1/fussballde/matchday?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| competition_id | string | Yes | 031BFREJC800001BVS5489BUVUR5FS5A-G | Competition id from fussballde-competitions |
| date | string | No | Matchday date as YYYY-MM-DD; omit for the current matchday; cannot be combined with matchday | |
| matchday | integer | No | Matchday number, 1 to the competition's matchday count (34 for the Bundesliga); cannot be combined with date |
{
"code": 200,
"msg": "OK",
"data": {
"competition_id": "031BFREJC800001BVS5489BUVUR5FS5A-G",
"count": 4,
"matchday": 3,
"matchday_count": 34,
"matches": [
{
"away": {
"club_id": "00ES8GN8OC00001LVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8OC00001LVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "FC Schalke 04",
"team_id": "011MIA6VDK000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/fc-schalke-04-fc-schalke-04-westfalen/-/saison/2627/team-id/011MIA6VDK000000VTVG0001VTR8C1K7"
},
"away_score": 3,
"date": "2026-09-11",
"home": {
"club_id": "00ES8GNCAC0000ABVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GNCAC0000ABVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "1. FC Union Berlin",
"team_id": "011MIDMV1G000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/1-fc-union-berlin-1fc-union-berlin-berlin/-/saison/2627/team-id/011MIDMV1G000000VTVG0001VTR8C1K7"
},
"home_score": 1,
"id": "031BFTHCLS000000VS5489BUVUR5FS5A",
"status": "finished",
"time": "20:30",
"url": "https://www.fussball.de/spiel/1-fc-union-berlin-fc-schalke-04/-/spiel/031BFTHCLS000000VS5489BUVUR5FS5A#!/section/course"
},
{
"away": {
"club_id": "00ES8GN8QS000024VV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8QS000024VV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "SC Paderborn 07",
"team_id": "011MIC6ATK000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/sc-paderborn-07-sc-paderborn-07-westfalen/-/saison/2627/team-id/011MIC6ATK000000VTVG0001VTR8C1K7"
},
"away_score": 0,
"date": "2026-09-12",
"home": {
"club_id": "00ES8GN8N400008VVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8N400008VVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "Borussia Dortmund",
"team_id": "011MI8V6UC000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/borussia-dortmund-borussia-dortmund-westfalen/-/saison/2627/team-id/011MI8V6UC000000VTVG0001VTR8C1K7"
},
"home_score": 3,
"id": "031BFTHCAK000000VS5489BUVUR5FS5A",
"status": "finished",
"time": "15:30",
"url": "https://www.fussball.de/spiel/borussia-dortmund-sc-paderborn-07/-/spiel/031BFTHCAK000000VS5489BUVUR5FS5A#!/section/course"
}
],
"title": "Bundesliga - Deutschland – Herren - 2026/2027",
"url": "http://127.0.0.1:52964/spieltag/x/-/spieltag/3/staffel/031BFREJC800001BVS5489BUVUR5FS5A-G"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.