Overview

Returns the current competition table for a football competition, including participating clubs, standings, match results, goals, ranking movement, and qualification/relegation indicators. Use it to display a league table for a competition such as the Premier League.

Inputs

id (string, required): Transfermarkt competition identifier. Example: GB1 for the Premier League.

Response

The endpoint returns a JSON object with:

success (boolean): Whether the request succeeded.
message (string): Status message, such as OK.
data.competitionId (string): Competition identifier.
data.tables (array): One or more competition tables. Each table contains:
clubs (array): Clubs and their current standings.
clubId (string): Club identifier.
group (object): Group metadata, including division and name.
game (object): Match record and points: isPlaying, points, pointsMinus, winCount, lossCount, drawCount, and totalCount.
goal (object): Goals scored, conceded, and difference through totalCount, concededCount, and differenceCount.
ranking (object): current, previous, and shift ranking values.
positioning (object): Qualification or relegation styling and description, including color and description.
meta.name (string): Display name of the table competition.
data.meta (object): Season and league-position metadata. The verified response includes seasonId, leagueSpots, and season (id, display, and cyclical/non-cyclical names).

The verified response contained a Premier League table with 20 clubs. Long arrays may be truncated in the returned sample; callers should treat tables[].clubs as a variable-length array.

Auth & browser

Authentication is not required by the endpoint definition. The request is sent directly to the Transfermarkt Technology API and does not require browser context.

Examples

Request

{
  "id": "GB1"
}

Success response

{
  "success": true,
  "message": "OK",
  "data": {
    "competitionId": "GB1",
    "tables": [
      {
        "clubs": [
          {
            "clubId": "281",
            "group": { "division": "", "name": "" },
            "game": {
              "isPlaying": false,
              "points": 15,
              "pointsMinus": null,
              "winCount": 5,
              "lossCount": 0,
              "drawCount": 0,
              "totalCount": 5
            },
            "goal": {
              "totalCount": 13,
              "concededCount": 5,
              "differenceCount": 8
            },
            "ranking": {
              "current": 1,
              "previous": 1,
              "shift": "UNCHANGED"
            },
            "positioning": {
              "color": "#afd179",
              "description": "Champions & UEFA Champions League"
            }
          },
          {
            "clubId": "148",
            "group": { "division": "", "name": "" },
            "game": {
              "isPlaying": false,
              "points": 2,
              "pointsMinus": null,
              "winCount": 0,
              "lossCount": 3,
              "drawCount": 2,
              "totalCount": 5
            },
            "goal": {
              "totalCount": 2,
              "concededCount": 8,
              "differenceCount": -6
            },
            "ranking": {
              "current": 20,
              "previous": 20,
              "shift": "UNCHANGED"
            },
            "positioning": {
              "color": "#f8a7a3",
              "description": "Relegated"
            }
          }
        ],
        "meta": { "name": "Premier League" }
      }
    ],
    "meta": {
      "seasonId": 2026,
      "season": {
        "id": 2026,
        "display": "26/27",
        "cyclicalName": "2027",
        "nonCyclicalName": "26/27"
      }
    }
  }
}

The example is shortened from a verified response; the full response included the remaining clubs and additional leagueSpots metadata.

Notes

clubId values identify clubs but do not include club names in this response; use a club endpoint to retrieve club details.
ranking.shift may indicate movement such as UNCHANGED.
positioning.description is empty when no qualification or relegation label applies.
The returned season is supplied by the upstream competition table and may change over time.