Docs menu

FUSSBALL.DE API endpoint

FUSSBALL.DE Competition Options API

Returns the team types (Herren, Frauen, A-Junioren, ...), the leagues (Spielklassen) of each team type and the areas (Gebiete) of each league for one federation, season and competition type. Team type, league and area ids are federation-specific, so take them from this response and pass them to `fussballde-competitions`.

GETapiKey1 credit/requestFUSSBALL.DEfussballde.competitionOptionsResponseDoc/fussballde/competition-options

Endpoint facts

Method: GET
API path: /fussballde/competition-options
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: FUSSBALL.DE
Response schema: #/definitions/fussballde.competitionOptionsResponseDoc

FUSSBALL.DE German Football Data API Try FUSSBALL.DE Competition Options API in Playground FUSSBALL.DE API documentation

How this endpoint behaves

Query parameters

federation_id (string, required): Federation id. Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. Names: 89 Deutschland, 32 Baden, 31 Bayern, 66 Berlin, 61 Brandenburg, 02 Bremen, 03 Hamburg, 34 Hessen, 62 Mecklenburg-Vorpommern, 23 Mittelrhein, 22 Niederrhein, 01 Niedersachsen, 41 Rheinland, 43 Saarland, 63 Sachsen, 64 Sachsen-Anhalt, 04 Schleswig-Holstein, 33 Südbaden, 42 Südwest, 65 Thüringen, 21 Westfalen, 35 Württemberg.
season (string, required): Four-digit season code, 2627 for 2026/27.
competition_type (string, optional): Competition type id, default 1. Allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12. Names: 1 Meisterschaften, 308 Pokale, 300 Turniere, 70 Freundschaftsspiele, 305 Spielnachmittage, -300 Kinderfußball (Turniere), -305 Kinderfußball (Spielnachmittage), 11 Futsal-Ligabetrieb, 2 Hallenturniere, -2 Kinderfußball (Hallenturniere), 12 Beachsoccer-Meisterschaften.

Response

Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Scores, dates and names that FUSSBALL.DE serves as obfuscated glyphs are decoded server-side. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.

Request parameters

Parameter	Type	Required	Description	Example
federation_id	string	Yes	Federation id Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35.	89
season	string	Yes	Four-digit season code, 2627 for 2026/27	2627
competition_type	string	No	Competition type id, default 1 Allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12.	1
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/fussballde/competition-options?federation_id=89&season=2627&competition_type=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "competition_type": "1",
    "federation_id": "89",
    "season": "2627",
    "team_types": [
      {
        "id": "1",
        "leagues": [
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "1",
            "name": "Bundesliga"
          },
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "2",
            "name": "2.Bundesliga"
          }
        ],
        "name": "Herren"
      },
      {
        "id": "3",
        "leagues": [
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "1",
            "name": "Bundesliga"
          },
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "4",
            "name": "Regionalliga"
          }
        ],
        "name": "A-Junioren"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/fussballde.competitionOptionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	fussballde.CompetitionOptionsResponse	No
data.competition_type	string	No	1
data.federation_id	string	No	89
data.season	string	No	2627
data.team_types	array	No
data.team_types[].id	string	No	1
data.team_types[].leagues	array	No
data.team_types[].leagues[].areas	array	No
data.team_types[].leagues[].areas[].id	string	No	2627
data.team_types[].leagues[].areas[].name	string	No	26/27
data.team_types[].leagues[].id	string	No	1
data.team_types[].leagues[].name	string	No	Bundesliga
data.team_types[].name	string	No	Herren
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/fussballde/competition-options?federation_id=89&season=2627&competition_type=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More FUSSBALL.DE endpoint docs FUSSBALL.DE German Football Data API FUSSBALL.DE Amateur Stats API documentation FUSSBALL.DE Club Matches API documentation FUSSBALL.DE Club Search API documentation FUSSBALL.DE Club API documentation FUSSBALL.DE Competitions API documentation FUSSBALL.DE Federation API documentation

Open in Playground Back to group

Docs menu

FUSSBALL.DE API endpoint

FUSSBALL.DE Competition Options API

GETapiKey1 credit/requestFUSSBALL.DEfussballde.competitionOptionsResponseDoc/fussballde/competition-options

Endpoint facts

Method: GET
API path: /fussballde/competition-options
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: FUSSBALL.DE
Response schema: #/definitions/fussballde.competitionOptionsResponseDoc

FUSSBALL.DE German Football Data API Try FUSSBALL.DE Competition Options API in Playground FUSSBALL.DE API documentation

How this endpoint behaves

Query parameters

federation_id (string, required): Federation id. Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. Names: 89 Deutschland, 32 Baden, 31 Bayern, 66 Berlin, 61 Brandenburg, 02 Bremen, 03 Hamburg, 34 Hessen, 62 Mecklenburg-Vorpommern, 23 Mittelrhein, 22 Niederrhein, 01 Niedersachsen, 41 Rheinland, 43 Saarland, 63 Sachsen, 64 Sachsen-Anhalt, 04 Schleswig-Holstein, 33 Südbaden, 42 Südwest, 65 Thüringen, 21 Westfalen, 35 Württemberg.
season (string, required): Four-digit season code, 2627 for 2026/27.
competition_type (string, optional): Competition type id, default 1. Allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12. Names: 1 Meisterschaften, 308 Pokale, 300 Turniere, 70 Freundschaftsspiele, 305 Spielnachmittage, -300 Kinderfußball (Turniere), -305 Kinderfußball (Spielnachmittage), 11 Futsal-Ligabetrieb, 2 Hallenturniere, -2 Kinderfußball (Hallenturniere), 12 Beachsoccer-Meisterschaften.

Response

Request parameters

Parameter	Type	Required	Description	Example
federation_id	string	Yes	Federation id Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35.	89
season	string	Yes	Four-digit season code, 2627 for 2026/27	2627
competition_type	string	No	Competition type id, default 1 Allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12.	1
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/fussballde/competition-options?federation_id=89&season=2627&competition_type=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "competition_type": "1",
    "federation_id": "89",
    "season": "2627",
    "team_types": [
      {
        "id": "1",
        "leagues": [
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "1",
            "name": "Bundesliga"
          },
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "2",
            "name": "2.Bundesliga"
          }
        ],
        "name": "Herren"
      },
      {
        "id": "3",
        "leagues": [
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "1",
            "name": "Bundesliga"
          },
          {
            "areas": [
              {
                "id": "0123456789ABCDEF0123456700004010",
                "name": "Deutschland"
              }
            ],
            "id": "4",
            "name": "Regionalliga"
          }
        ],
        "name": "A-Junioren"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/fussballde.competitionOptionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	fussballde.CompetitionOptionsResponse	No
data.competition_type	string	No	1
data.federation_id	string	No	89
data.season	string	No	2627
data.team_types	array	No
data.team_types[].id	string	No	1
data.team_types[].leagues	array	No
data.team_types[].leagues[].areas	array	No
data.team_types[].leagues[].areas[].id	string	No	2627
data.team_types[].leagues[].areas[].name	string	No	26/27
data.team_types[].leagues[].id	string	No	1
data.team_types[].leagues[].name	string	No	Bundesliga
data.team_types[].name	string	No	Herren
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/fussballde/competition-options?federation_id=89&season=2627&competition_type=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

FUSSBALL.DE Competition Options API

Endpoint facts

How this endpoint behaves

Query parameters

Response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

FUSSBALL.DE Competition Options API

Endpoint facts

How this endpoint behaves

Query parameters

Response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related