CLclubplatform
Schedule

Schedule of current season for club

Returns list of scheduled matches of current season where the club is member of. Matches returns in date and start time order.

You could also fetch the schedule in iCalendar format if you set Accept: text/calendar or use the .ics extension.

get/clubs/{club_id}/current_seasons/schedule

Request

  • Base URL
    https://api.clubplatform.de/api
  • URL
    https://api.clubplatform.de/api/clubs/{club_id}/current_seasons/schedule
  • Auth
    API key in query parameter auth_token

Path parameters

club_idinteger required

ID of the club.

Query parameters

alignment'away' | 'home'

Filter matches by team alignment of the club.

group_idinteger

Filter matches by group.

tournament_ids[]integer[]

Filter matches by tournament.

previousinteger

Number of matches before yesterday to limiting the returning matches.

nextinteger

Number of matches since yesterday to limiting the returning matches. The value includes yesterday.

locale'de-DE' | 'en-GB' | 'nl-NL'

The response will be in that locale.

NOTE: The locale must be whitelisted for your club! If not the locale for the auth_token will be used as default.

Filter ItemsSet locale
❌✅

Headers

If-Modified-Sincestring date-time

This makes the request conditional - the server will send back the requested resource, with a 200 status, only if it has been last modified after the given date. If the request has not been modified since, the response will be a 304 without any body; the Last-Modified header will contain the date of last modification.

You MUST set this header, if you can, to respect API caching.

Response

OK

Example response

{
  "date": [
    {
      "id": 42,
      "start_date_time": "2016-08-22T20:45:00+02:00",
      "start_weekday": "wednesday",
      "group": {
        "id": 6,
        "name": "Gruppe F"
      },
      "site": {
        "id": 45,
        "name": "Red Bull Arena",
        "built": 2004,
        "seats": 42959,
        "surface": "turf",
        "url": "www.sportforum-leipzig.com",
        "city": "Leipzig",
        "postal_code": "04105",
        "street": "Am Sportforum, 3",
        "pitch": {
          "x": 105,
          "y": 68
        }
      },
      "teams": [
        {
          "id": 1401830,
          "name": "SV Eintracht Trier 05",
          "club": {
            "id": 81
          }
        }
      ],
      "tournament": {
        "id": 1,
        "name": "Bundesliga",
        "handle": "BUNDESLIGA",
        "number_of_rounds": 34
      },
      "season": {
        "id": 1573213,
        "name": "2016/2017",
        "tournament_id": 3,
        "number_of_rounds": 7
      },
      "round": {
        "id": 2,
        "name": "2. Spieltag"
      },
      "division": {
        "id": 1,
        "name": "First half of the season"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.