---
title: "Electronic Program Guide"
method: GET
path: "/clubs/{club_id}/epg"
tags: ["EPG"]
---

# Electronic Program Guide

`GET /clubs/{club_id}/epg`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/clubs/{club_id}/epg`
- Auth: API key in query parameter `auth_token`

Location-specific broadcast information for matches of 1st and 2nd
Bundesliga.

The response varies depending on the `location` query parameter.
It denotes an ISO 3166-1 two-letter country code specifying the
requesting device's geographical position, e.g. `DE`, `GB`, `NL`,
etc. When the `location` query parameter is absent, its value defaults
to the club's home country.

Responds with the most recently updated 30 broadcasts for the club's
matches available in the location.

## Path parameters

- `club_id` integer, required

## Query parameters

- `location` string

## Headers

- `If-Modified-Since` string, date-time

## Response `200`

OK

- object
  - `data` object[]: Array of broadcasts.
    - `match_id` integer: ID of the covered match.
    - `light_logo_url` string: URL of the broadcaster's light logo.
    - `light_logo_category` 'unknown' | 'compact' | 'regular' | 'wide': Type of the broadcaster's light logo.
    - `dark_logo_url` string: URL of the broadcaster's dark logo.
    - `dark_logo_category` 'unknown' | 'compact' | 'regular' | 'wide': Type of the broadcaster's dark logo.
    - `broadcaster_name` string: Name of the broadcaster.
    - `local_start_date_time` string, date-time: Local start time of the broadcast.
    - `link_rel` 'facebook' | 'twitter' | 'homepage' | 'whatsapp' | 'google_plus' | 'generic_link': Type of link to the broadcast.
    - `link_href` string: Link to the broadcast.
    - `country` string: ISO 3166-1 two-letter country code specifying the location of the broadcast.

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)