Endpoint Playground
Returns the matches FUSSBALL.DE's Matchkalender lists around a five-digit postcode within a date range (default today plus six days, at most 92 days), optionally filtered by team types and competition kind. Each match includes its team type (for example D-Junioren) and league. The upstream returns at most 10 matches per request and has no paging: `truncated` is true when the page is full, so narrow the dates or filters to see the rest. Zero matches is a valid response.
curl 'https://api.crawlora.net/api/v1/fussballde/match-calendar?postal_code=44139&competition_kind=1' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| postal_code | string | Yes | 44139 | Five-digit German postcode; look one up with fussballde-postal-codes |
| date_from | string | No | First day as YYYY-MM-DD, default today (Europe/Berlin) | |
| date_to | string | No | Last day as YYYY-MM-DD, at most 92 days after date_from, default six days after date_from | |
| team_types | string | No | Comma-separated team type ids such as 1,3; omit for all team types | |
| competition_kind | string | No | 1 | Competition kind id; omit for all kinds |
{
"code": 200,
"msg": "OK",
"data": {
"count": 2,
"date_from": "2026-10-24",
"date_to": "2026-10-31",
"matches": [
{
"away": {
"club_id": "00ES8GN8QS00009FVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8QS00009FVV0AG08LVUPGND5I",
"name": "Spielverein Westfalia Soest",
"team_id": "011MIEU318000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/spielverein-westfalia-soest-sv-westfalia-soest-westfalen/-/saison/2627/team-id/011MIEU318000000VTVG0001VTR8C1K7"
},
"date": "2026-10-24",
"home": {
"club_id": "00ES8GN8N4000095VV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8N4000095VV0AG08LVUPGND5I",
"name": "TSC Eintracht Dortmund II",
"team_id": "011MI9U5J4000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/tsc-eintracht-dortmund-ii-tsc-eintracht-48-95-westfalen/-/saison/2627/team-id/011MI9U5J4000000VTVG0001VTR8C1K7"
},
"id": "032DCS3SJ8000000VS5489BTVU989P58",
"league": "Kreisfreundschaftsspiele",
"status": "scheduled",
"team_type": "A-Junioren",
"time": "14:30",
"url": "https://www.fussball.de/spiel/tsc-eintracht-dortmund-ii-spielverein-westfalia-soest/-/spiel/032DCS3SJ8000000VS5489BTVU989P58"
},
{
"away": {
"club_id": "00ES8GN8UK00006IVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8UK00006IVV0AG08LVUPGND5I",
"name": "DJK-VFL Willich A1",
"team_id": "011MIC2NE0000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/djk-vfl-willich-a1-djk-vfl-1919-willich-niederrhein/-/saison/2627/team-id/011MIC2NE0000000VTVG0001VTR8C1K7"
},
"date": "2026-10-25",
"home": {
"club_id": "00ES8GN8N4000095VV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8N4000095VV0AG08LVUPGND5I",
"name": "TSC Eintracht Dortmund II",
"team_id": "011MI9U5J4000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/tsc-eintracht-dortmund-ii-tsc-eintracht-48-95-westfalen/-/saison/2627/team-id/011MI9U5J4000000VTVG0001VTR8C1K7"
},
"id": "032DCSCCT0000000VS5489BTVU989P58",
"league": "Kreisfreundschaftsspiele",
"status": "scheduled",
"team_type": "A-Junioren",
"time": "17:00",
"url": "https://www.fussball.de/spiel/tsc-eintracht-dortmund-ii-djk-vfl-willich-a1/-/spiel/032DCSCCT0000000VS5489BTVU989P58"
}
],
"postal_code": "44139",
"truncated": false
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.