Overview

Returns structured details for a football competition, including its identity, current season, format, market value, historical metadata, and logo.

Inputs

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

Response

The endpoint returns a JSON envelope:

success (boolean): Whether the request succeeded.
message (string): Status message, such as OK.
data (object): Competition details, including:
id, name, shortName (string): Competition identifiers and display names.
currentSeasonId (number): Current season identifier.
originDetails (object): Country and confederation identifiers.
baseDetails (object): Competition format and status, including game-day count, duration, ongoing status, tournament status, and stage.
totalMarketValue (object): Aggregate market value with numeric value, currency, and compact display fields.
showMarketValue (boolean), typeId (number), and relativeUrl (string).
historical (object): Historical names and competition images.
identifier (string): Human-readable competition identifier.
currentSeason (object): Current season IDs and display names.
logoUrl (string): Competition logo URL.

Auth & browser

Authentication is not required. This is a GET request and does not require a browser context.

Examples

Request inputs:

{
  "id": "GB1"
}

Verified success response (selected fields; long historical image arrays are abbreviated):

{
  "success": true,
  "message": "OK",
  "data": {
    "id": "GB1",
    "name": "Premier League",
    "shortName": "Premier League",
    "currentSeasonId": 2026,
    "originDetails": {
      "countryId": 189,
      "confederationId": 6
    },
    "baseDetails": {
      "standardGameDurationMinutes": 90,
      "gameDayCount": 38,
      "isOngoing": true,
      "isTournament": false,
      "stage": "none"
    },
    "totalMarketValue": {
      "value": 13158125000,
      "currency": "EUR",
      "compact": {
        "prefix": "€",
        "content": "13.16",
        "suffix": "B"
      }
    },
    "identifier": "Premier League (GB1)",
    "currentSeason": {
      "id": 2026,
      "display": "26/27",
      "cyclicalName": "2027",
      "nonCyclicalName": "26/27"
    },
    "logoUrl": "https://img.a.transfermarkt.technology/logo/medium/gb1.png?lm=1789377131"
  }
}

Notes

The verified response includes a potentially large historical.images array. The example shows selected fields and omits additional historical image entries for readability.